> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://ixopay.ferndocs.com/modules/payments-intelligence/observability/kp-is/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server. # KPIs In this section, you can find the relevant KPIs glossary for the IXOPAY Payments Intelligence Observability and Analytics sections. ## 🔎 KPI Areas and Descriptions ### 1. Data Dictionary This table defines the granular dimensions available for filtering and grouping within each KPI area. | KPI Area | Value Name | Description | | --------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------- | | 3ds | 3ds\_challenge\_status | 3D Secure events by the status of the 3D Secure challenge | | 3ds | 3ds\_version\_success\_rate | 3D Secure events success rate by the version of 3D Secure | | 3ds | billing\_country | 3D Secure events by country of the shopper billing address | | 3ds | currency | 3D Secure events by currency of the transaction | | 3ds | gateway | 3D Secure events by the PSP | | 3ds | issuing\_bank | 3D Secure events by country of the shopper billing address | | 3ds | issuing\_country | 3D Secure events by country of the payment instrument used | | 3ds | merchant\_account | 3D Secure events by the corresponding sub account with PSP | | 3ds | response\_code | 3D Secure events with the detailed response code | | 3ds | sca\_exemption\_response\_code | 3D Secure events by the response code for the Strong Customer Authentication | | 3ds | sca\_exemption\_type | 3D Secure events by the strong customer authentication exemption | | 3ds | scheme | 3D Secure events by underlying payment system | | authorizations | 3d\_secure\_status | All attempts to reserve money from the payment instrument by status of the 3D Secure check | | authorizations | billing\_country | All attempts to reserve money from the payment instrument by country of the shopper billing address | | authorizations | bin | All attempts to reserve money from the payment instrument by Bank Identifier Number of the payment instrument used | | authorizations | card\_type | All attempts to reserve money from the payment instrument by the card type | | authorizations | currency | All attempts to reserve money from the payment instrument by currency of the transaction | | authorizations | eci | All attempts to reserve money from the payment instrument by Electronic Commerce Indicator flag | | authorizations | entry\_mode | All attempts to reserve money from the payment instrument by sales channel used | | authorizations | flag | All attempts to reserve money from the payment instrument by flag | | authorizations | gateway | All attempts to reserve money from the payment instrument by the payment provider | | authorizations | issuing\_bank | All attempts to reserve money from the payment instrument by the name of the bank behind the used payment instrument | | authorizations | issuing\_country | All attempts to reserve money from the payment instrument by country of the payment instrument used | | authorizations | merchant\_account | All attempts to reserve money from the payment instrument by the corresponding sub account with PSP | | authorizations | payment\_method | All attempts to reserve money from the payment instrument by the used payment method | | authorizations | reason\_code | All attempts to reserve money from the payment instrument with the detailed response from the PSP | | authorizations | region | All attempts to reserve money from the payment instrument by the payment region | | authorizations | sca\_exception | All attempts to reserve money from the payment instrument by the strong customer authentication exemption | | authorizations | sca\_flow | All attempts to reserve money from the payment instrument by the strong customer authentication route | | authorizations | scheme | All attempts to reserve money from the payment instrument by underlying payment system | | authorizations | status | All attempts to reserve money from the payment instrument with the status response from the PSP | | chargebacks | billing\_country | Chargebacks by country of the shopper billing address | | chargebacks | currency | Chargebacks by currency of the transaction | | chargebacks | gateway | Chargebacks by the PSP | | chargebacks | issuing\_bank | Chargebacks by country of the shopper billing address | | chargebacks | issuing\_country | Chargebacks by country of the payment instrument used | | chargebacks | lifecycle | Chargeback events by the type of the event in the chargeback lifecycle | | chargebacks | merchant\_account | Chargebacks by the corresponding sub account with PSP | | chargebacks | payment\_method | Chargebacks by the payment method used | | chargebacks | reason\_code | Chargebacks with the detailed reason code for the dispute | | chargebacks | reason\_code\_category | Chargebacks with grouped reasons for the disputes | | chargebacks | region | Chargebacks by the payment region | | chargebacks | sca\_exemption | Chargebacks by the strong customer authentication exemption | | chargebacks | scheme | Chargebacks by underlying payment system | | decline\_analysis | billing\_country | Declines by country of the shopper billing address | | decline\_analysis | bin | Declines by Bank Identifier Number of the payment instrument used | | decline\_analysis | card\_type | Declines by the card type | | decline\_analysis | gateway | Declines broken down by the PSP | | decline\_analysis | issuer\_country | Declines by country of the payment instrument used | | decline\_analysis | issuing\_bank | Declines by the name of the bank behind the used payment instrument | | decline\_analysis | merchant\_account | Declines by the corresponding sub account with PSP | | decline\_analysis | payment\_method | Declines by the used payment method | | decline\_analysis | processing\_currency | Declines by currency of the transaction | | decline\_analysis | reason\_code | Declines with the detailed response from the PSP | | decline\_analysis | region | Declines by the payment region | | decline\_analysis | scheme | Declines by underlying payment system | | decline\_analysis | status | Declines with the status response from the PSP | | fees | billing\_country | Fees by country of the shopper billing address | | fees | card\_type | Fees by the fee type | | fees | gateway | Fees by the payment method used | | fees | issuer\_country | Fees by country of the payment instrument used | | fees | merchant\_account | Fees by the corresponding sub account with PSP | | fees | payment\_method | Fees by the payment method used | | fees | processing\_currency | Fees by currency of the transaction | | fees | scheme | Fees by underlying payment system | | fees | settlement\_currency | Fees by currency of the final payout | | fees | type | Fees by the PSP | | sales\_and\_refunds | billing\_country | Sales and Refunds by country of the shopper billing address | | sales\_and\_refunds | bin | Sales and Refunds by Bank Identifier Number of the payment instrument used | | sales\_and\_refunds | card\_type | Sales and Refunds by the card type | | sales\_and\_refunds | gateway | Sales and Refunds by the PSP | | sales\_and\_refunds | issuer\_country | Sales and Refunds by the name of the bank behind the used payment instrument | | sales\_and\_refunds | issuing\_bank | Sales and Refunds by the name of the bank behind the used payment instrument | | sales\_and\_refunds | merchant\_account | Sales and Refunds by the corresponding sub account with PSP | | sales\_and\_refunds | payment\_method | Sales and Refunds by the payment method used | | sales\_and\_refunds | processing\_currency | Sales and Refunds by currency of the transaction | | sales\_and\_refunds | reason\_code | Sales and Refunds with the detailed response from the PSP | | sales\_and\_refunds | region | Sales and Refunds by the payment region | | sales\_and\_refunds | scheme | Sales and Refunds by underlying payment system | | sales\_and\_refunds | settlement\_currency | Sales and Refunds by currency of the final payout | | transaction\_insights | billing\_country | All the events from the PSPs by country of the shopper billing address | | transaction\_insights | bin | All events from the PSPs by Bank Identifier Number of the payment instrument used | | transaction\_insights | currency | All events from the PSPs by currency of the transaction | | transaction\_insights | event\_type | All events from the PSPs by the type of the underlying event | | transaction\_insights | gateway | All events by the PSPs where they were registered | | transaction\_insights | gateway\_event | All events by the PSPs where they were registered | | transaction\_insights | issuer\_country | All events from the PSPs by country of the payment instrument used | | transaction\_insights | issuing\_bank | All events from the PSPs by Bank Identifier Number of the payment instrument used | | transaction\_insights | merchant\_account | All events from the PSPs and the corresponding sub account with those | | transaction\_insights | payment\_method | All events from the PSPs by the payment method used | | transaction\_insights | scheme | All events from the PSPs by underlying payment system | ### 2. Data KPIs This table contains the specific metrics and their business definitions. | KPI ID | KPI Area | KPI Definition | KPI Description | | --------------------------------- | --------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------- | | SECURE\_3D\_AUTH\_SUCCESS\_COUNT | 3ds | Count of successful 3DS authentications | Count of Successful Authentications | | SECURE\_3D\_AUTH\_SUCCESS\_RATE | 3ds | Success rate of 3DS authentication | Rate of Successful Authentications | | SECURE\_3D\_AUTH\_SUCCESS\_VOLUME | 3ds | Volume of successful 3DS auth | Volume of Successful Authentications | | SECURE\_3D\_CHALLENGED\_COUNT | 3ds | Count of challenged 3DS transactions | Count of Challenged Transactions | | SECURE\_3D\_CHALLENGED\_RATE | 3ds | Rate of transactions challenged during 3D Secure authentication | Percent of 3D Secure Authentication Requests that are Challenged | | SECURE\_3D\_CHALLENGED\_VOLUME | 3ds | Volume of challenged 3DS transactions | Volume of Challenged Transactions | | SECURE\_3D\_EVENTS\_COUNT | 3ds | Count of 3DS events | 3DS Count | | SECURE\_3D\_EVENTS\_PERCENT | 3ds | % of transactions using 3DS | 3DS Rate | | SECURE\_3D\_EVENTS\_VOLUME | 3ds | Volume of 3DS events | Volume of 3DS Events | | SECURE\_3D\_EXEMPTIONS\_COUNT | 3ds | Count of exempted 3DS transactions | Count of Exempted Events | | SECURE\_3D\_EXEMPTIONS\_RATE | 3ds | % of exempted 3DS transactions | Rate of Exemptions | | SECURE\_3D\_EXEMPTIONS\_VOLUME | 3ds | Volume of exempted 3DS transactions | Volume of Exempted Events | | AUTHORIZATION\_COUNT | authorizations | Total authorization requests | Count of Authorization Requests | | AUTHORIZATION\_RATE | authorizations | % of successful authorizations | Rate of Successful Authorizations | | AUTHORIZATION\_SUCCESS\_COUNT | authorizations | Count of approved authorizations | Count of Successful Authorizations | | AUTHORIZATION\_SUCCESS\_VOLUME | authorizations | Volume of successful authorizations | Successful Authorizations Volume | | AUTHORIZATION\_TOTAL\_PERC | authorizations | Share of authorizations | Share Authorizations Count | | AUTHORIZATION\_VOLUME | authorizations | Volume of authorization requests | Volume of Authorization Requests | | CHARGEBACK\_EVENTS\_COUNT | chargebacks | Count of chargeback events | Chargebacks Events Count | | CHARGEBACK\_EVENTS\_VOLUME | chargebacks | Volume of chargeback events | Chargebacks Events Volume | | CHARGEBACK\_FIRST\_COUNT | chargebacks | Count of first chargebacks | Count of 1st Chargebacks | | CHARGEBACK\_FIRST\_RATE | chargebacks | % of first chargebacks | Rate of 1st Chargebacks | | CHARGEBACK\_FIRST\_VOLUME | chargebacks | Volume of first chargebacks | Volume of 1st Chargebacks | | CHARGEBACK\_SECOND\_COUNT | chargebacks | Count of second chargebacks | Count of 2nd Chargebacks | | CHARGEBACK\_SECOND\_RATE | chargebacks | % of second chargebacks | Rate of 2nd Chargebacks | | CHARGEBACK\_SECOND\_VOLUME | chargebacks | Volume of second chargebacks | Volume of 2nd Chargebacks | | CHARGEBACK\_TOTAL\_PERC | chargebacks | Share of all chargeback events | Share Chargebacks Events | | CHARGEBACK\_WON\_COUNT | chargebacks | Count of won chargebacks | Won Chargebacks Count | | CHARGEBACK\_WON\_RATE | chargebacks | % of won chargebacks | Percentage of Won Chargebacks | | CHARGEBACK\_WON\_VOLUME | chargebacks | Volume of won chargebacks | Volume of Won Chargebacks | | DECLINE\_COUNT | decline\_analysis | Count of declines | Declines Count | | DECLINE\_RATE | decline\_analysis | % of declined authorization requests | Rate of Declines | | DECLINE\_TOTAL\_PERC | decline\_analysis | Share of declined authorization requests | Share of Declines | | DECLINE\_VOLUME | decline\_analysis | Volume of declines | Declines Volume | | GATEWAY\_DECLINE\_COUNT | decline\_analysis | Count of gateway declines | Count of Gateway Declines | | GATEWAY\_DECLINE\_RATE | decline\_analysis | % of gateway declines | Gateway Declines Rate | | GATEWAY\_DECLINE\_VOLUME | decline\_analysis | Volume of gateway declines | Volume of Gateway Declines | | ISSUER\_DECLINE\_COUNT | decline\_analysis | Count of issuer declines | Count of Issuer Declines | | ISSUER\_DECLINE\_RATE | decline\_analysis | % of declines caused by issuing bank | Percent of Requests Declined by Payment Issuer | | ISSUER\_DECLINE\_VOLUME | decline\_analysis | Volume of issuer declines | Volume of Issuer Declines | | ACQUIRER\_FEES\_GROSS\_RATE | fees | Acquirer fees vs gross sales | Rate (Gross) of Acquirer Fees | | ACQUIRER\_FEES\_RATE | fees | Acquirer fees vs sales | Rate of Acquirer Fees | | ACQUIRER\_FEES\_VOLUME | fees | Volume of acquirer fees | Acquirer Fees Volume | | BLENDED\_FEES\_RATE | fees | Blended fees vs sales | Rate of Blended Fees | | BLENDED\_FEES\_VOLUME | fees | Total blended fees volume | Volume of Blended Fees | | CHARGEBACK\_FEES\_RATE | fees | Chargeback fees vs sales | Rate of Chargeback Fees | | CHARGEBACK\_FEES\_VOLUME | fees | Volume of chargeback fees | Volume of Chargeback Fees | | CONVERSION\_FEES\_RATE | fees | Conversion fees relative to sales volume | Conversion Fees rate according to Sales | | CONVERSION\_FEES\_VOLUME | fees | Fees charged for currency conversion transactions | Total Volume (in Euros) of Conversion Fees | | FEES\_COUNT | fees | Count of fees | Fees Count | | FEES\_GROSS\_RATE | fees | Total fees vs gross sales | Rate (Gross) of Fees | | FEES\_PROCESSED\_AMOUNT | fees | Volume of fee-related events | Volume of Events (Fees) | | FEES\_RATE | fees | Total fees relative to sales/net sales | Total Fees rate according to Sales | | FEES\_SALES\_VOLUME | fees | Sales volume from fees reports | Sales Volume (Fees) | | FEES\_TOTAL\_PERC | fees | Share of total fees | Share Fees Count | | FEES\_VOLUME | fees | Total volume of payment fees | Total Volume of Fees | | GATEWAY\_FEES\_RATE | fees | Gateway fees vs sales | Gateway Fees Rate | | GATEWAY\_FEES\_VOLUME | fees | Volume of gateway fees | Volume of Gateway Fees | | INTERCHANGE\_FEES\_RATE | fees | Interchange fees vs sales | Rate of Interchange Fees | | INTERCHANGE\_FEES\_VOLUME | fees | Volume of interchange fees | Volume of Interchange Fees | | NON\_TRX\_FEES\_RATE | fees | Rate of non-transactional fees | Rate of Non-Transactional Fees | | NON\_TRX\_FEES\_VOLUME | fees | Volume of non-transactional fees | Non-Transactional Fees Volume | | PROCESSING\_FEES\_RATE | fees | Processing fees vs sales | Rate of Processing Fees | | PROCESSING\_FEES\_VOLUME | fees | Volume of processing fees | Processing Fees Volume | | SCHEME\_FEES\_RATE | fees | Scheme fees vs sales | Scheme Fees Rate | | SCHEME\_FEES\_VOLUME | fees | Volume of scheme fees | Volume of Scheme Fees | | FRAUD\_TRANSACTIONS\_COUNT | fraud\_vamp | Count of fraud transactions | Fraud Transactions Count | | FRAUD\_TRANSACTIONS\_RATE | fraud\_vamp | Fraud rate vs sales | Fraud Transactions Rate | | FRAUD\_TRANSACTIONS\_VOLUME | fraud\_vamp | Volume of fraud transactions | Fraud Transactions Volume | | VAMP\_COUNT | fraud\_vamp | Fraud + chargeback count | VAMP Count | | VAMP\_RATIO | fraud\_vamp | Fraud+chargebacks vs sales | VAMP Rate | | VAMP\_TOTAL\_PERC | fraud\_vamp | Share of fraud + chargebacks | VAMP Total Percentage | | VAMP\_VOLUME | fraud\_vamp | Volume of fraud + chargebacks | VAMP Volume | | VISA\_CHARGEBACK\_FIRST\_COUNT | fraud\_vamp | Count of Visa chargebacks | 1st Chargebacks Count (Visa) | | VISA\_CHARGEBACK\_FIRST\_RATE | fraud\_vamp | Rate of first chargebacks for Visa | Percentage of Visa Sales that result in a First Chargeback | | VISA\_CHARGEBACK\_FIRST\_VOLUME | fraud\_vamp | Volume of Visa chargebacks | 1st Chargebacks Volume (Visa) | | VISA\_SALES\_COUNT | fraud\_vamp | Count of Visa sales | Sales Count (Visa) | | VISA\_SALES\_VOLUME | fraud\_vamp | Volume of Visa sales | Sales Volume (Visa) | | AVERAGE\_SALES | sales\_and\_refunds | Average sales value | Average Sales | | FAILED\_SALES\_COUNT | sales\_and\_refunds | Number of sales that fail after successful authorization | Count of Failed Sales | | FAILED\_SALES\_VOLUME | sales\_and\_refunds | Volume of failed sales | Volume of Failed Sales | | NET\_SALES\_VOLUME | sales\_and\_refunds | Sales minus refunds | Net Sales Volume | | REFUND\_COUNT | sales\_and\_refunds | Number of refunded transactions | Count of Refunds | | REFUND\_RATE | sales\_and\_refunds | Refund rate vs sales | Refunds Rate | | REFUND\_VOLUME | sales\_and\_refunds | Volume of refunds | Volume of Refunds | | SALES\_COUNT | sales\_and\_refunds | Count of sales | Sales Count | | SALES\_TOTAL\_PERC | sales\_and\_refunds | Share of sales | Share Sales Count | | SALES\_VOLUME | sales\_and\_refunds | Volume of sales | Sales Volume | | EVENTS\_COUNT | transaction\_insights | Total number of events | Total Count of Events | | EVENTS\_TOTAL\_PERC | transaction\_insights | Share of total events | Share Events Count | | EVENTS\_VOLUME | transaction\_insights | Volume of events | Volume of Events |