Credit card deposits (via Kushki)

A white-label card-not-present/B2B solution allowing Merchants to execute SALE transactions.

🚧

Note that Deposit payments imply authorisation and capture in a single message.

The cut off time on provider side for all Capture requests to be sent to the respective Schema and Issuing Bank is 11pm local Mexico City time. Because of that if a deposit is executed during the day, then until the provider`s cut off time is reached a Cancel/Revert request can still be performed.

Depending on merchant preferences, PXP can make the following setup:

  1. Immediately move Deposit payment state from AuthorisedByProvider (13) to CapturedByProvider (27) after a successful authorisation response is returned for the respective Deposit payment.
  2. Delay the automated Deposit payment state swap from AuthorisedByProvider (13) to CapturedByProvider and execute it after the provider cut off time.

Supported Payment Methods to Trigger Card Deposit

IDNameCredit/Debit State
1ECMC DepositAuthorisedByProvider (13)
2Visa DepositAuthorisedByProvider (13)
113AMEX DepositAuthorisedByProvider (13)

Payment method interaction type: Redirection to External Payment Provider (see Interaction Types).

Supported Creation Types for Card Deposit

IDNameDescription
1UserPayment generated by user via web interface
10MerchantInitiatedWithStoredAccountPayment that is initiated by a merchant, with the consent of the cardholder, using the cardholder's stored credit card credentials
11UserInitiatedWithStoredAccountPayment that is initiated by a cardholder using the cardholder's stored credit card credentials

Redirect Integration

Currently not supported.

Backend2Backend Integration

The following table contains the fields to be sent in initiatePaymentRequest:

key (value type, account type, required)value
userIP (string, required)The IP of the user

The following table contains the fields to be sent in initiatePaymentRequest.specificPaymentData xml section:

key (value type, account type, required)value
PaymentDescription (string)Description of the payment
PaymentDescriptionLanguageCode (string)Language value for the description
PaymentProviderID (Int)The provider´s ID - 202 for Kushki

Please note that sending data of the user is essential for this payment method as the data is sent to provider. The following parameters are recommended in initiatePaymentRequest.userData xml section and are required by the provider Kushki:

key (value type, account type, required)value
Firstname (string)The user's first name
Lastname (string)The user's last name
Email (string)The user's email address
identificationNumber (string)The user´s document ID
telephoneNumber (string)The user´s phone number prefixed with the country code (Mexico: +52, Colombia: +57)
address > street (string)The user´s street address
address > houseNumber (string)The user´s house number
address > postalCode (string)The user´s postalCode
address > city (string)The user´s city
address > state (string)The user´s state
address > countryCode2 (string)The user´s country code

Request samples:

Example initiatePaymentRequest (ECMC Deposit):

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <merchantID>DemoMerchant</merchantID>
    <shopID>DemoShop</shopID>
    <merchantTransactionID>ab0278d1-c891-459d-9314-c6bd3ced01a3</merchantTransactionID>
    <paymentMethodID>1</paymentMethodID>
    <amount currencyCode="MXN">45.88</amount>
    <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
    <userData>
        <username>newusername</username>
        <firstname>Barry</firstname>
        <lastname>Allen</lastname>
        <currencyCode>MXN</currencyCode>
        <languageCode>ES</languageCode>
        <email>[email protected]</email>
        <address>
            <street>José María Pino Suárez</street>
            <houseNumber>30</houseNumber>
            <houseNumberExtension>B</houseNumberExtension>
            <postalCode>06060</postalCode>
            <city>Mexico City</city>
            <state>Mexico</state>
            <countryCode2>MX</countryCode2>
            <telephoneNumber>+5260000000</telephoneNumber>
        </address>
        <dateOfBirth>1980-10-10T00:00:00</dateOfBirth>
        <gender>Male</gender>
        <identificationNumber>HEGJ820506M10</identificationNumber>
    </userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>97741380-002w-4a09-2bad-7fbca3c512s0-v0</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescription</key>
            <value>5ded6850-b5b8-476f-8f29-bc2ad78b9e2e</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescriptionLanguageCode</key>
            <value>en</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>PaymentProviderID</key>
            <value>202</value>
        </data>
</specificPaymentData>
<paymentAccount>
    <specificPaymentAccountData>
        <data xsi:type="keyStringValuePair">
            <key>CardNumber</key>
            <value>5451951574925480</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>CardVerificationCode</key>
            <value>012</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>ExpiryMonth</key>
            <value>06</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>ExpiryYear</key>
            <value>2032</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>HolderName</key>
            <value>Barry Allen</value>
        </data>
    </specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>

Example initiatePaymentRequest (Visa Deposit):

<initiatePaymentRequest
    xmlns="http://www.cqrpayments.com/PaymentProcessing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <merchantID>DemoMerchant</merchantID>
    <shopID>DemoShop</shopID>
    <merchantTransactionID>1111141</merchantTransactionID>
    <paymentMethodID>2</paymentMethodID>
    <amount currencyCode="MXN">15.00</amount>
    <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
    <userData>
        <username>newusername</username>
        <firstname>Barry</firstname>
        <lastname>Allen</lastname>
        <currencyCode>MXN</currencyCode>
        <languageCode>ES</languageCode>
        <email>[email protected]</email>
        <address>
            <street>José María Pino Suárez</street>
            <houseNumber>30</houseNumber>
            <houseNumberExtension>B</houseNumberExtension>
            <postalCode>06060</postalCode>
            <city>Mexico City</city>
            <state>Mexico</state>
            <countryCode2>MX</countryCode2>
            <telephoneNumber>+5260000000</telephoneNumber>
        </address>
        <dateOfBirth>1980-10-10T00:00:00</dateOfBirth>
        <gender>Male</gender>
        <identificationNumber>HEGJ820506M10</identificationNumber>
    </userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>97741380-002w-4a09-2bad-7fbca3c512s0-v0</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescription</key>
            <value>5ded6850-b5b8-476f-8f29-bc2ad78b9e2e</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescriptionLanguageCode</key>
            <value>en</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>PaymentProviderID</key>
            <value>202</value>
        </data>
</specificPaymentData>
<paymentAccount>
    <specificPaymentAccountData>
        <data xsi:type="keyStringValuePair">
            <key>CardNumber</key>
            <value>4111111111111517</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>CardVerificationCode</key>
            <value>012</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>ExpiryMonth</key>
            <value>11</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>ExpiryYear</key>
            <value>2032</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>HolderName</key>
            <value>Barry Allen</value>
        </data>
    </specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>

Example initiatePaymentRequest (AMEX Deposit):

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <merchantID>DemoMerchant</merchantID>
    <shopID>DemoMerchant</shopID>
    <merchantTransactionID>20250624000000</merchantTransactionID>
    <paymentMethodID>113</paymentMethodID>
    <amount currencyCode="MXN">30.99</amount>
    <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
    <userData>
        <username>newusername</username>
        <firstname>Barry</firstname>
        <lastname>Allen</lastname>
        <currencyCode>MXN</currencyCode>
        <languageCode>ES</languageCode>
        <email>[email protected]</email>
        <address>
            <street>José María Pino Suárez</street>
            <houseNumber>30</houseNumber>
            <houseNumberExtension>B</houseNumberExtension>
            <postalCode>06060</postalCode>
            <city>Mexico City</city>
            <state>Mexico</state>
            <countryCode2>MX</countryCode2>
            <telephoneNumber>+5260000000</telephoneNumber>
        </address>
        <dateOfBirth>1980-10-10T00:00:00</dateOfBirth>
        <gender>Male</gender>
        <identificationNumber>HEGJ820506M10</identificationNumber>
    </userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>97741380-002w-4a09-2bad-7fbca3c512s0-v0</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescription</key>
            <value>5ded6850-b5b8-476f-8f29-bc2ad78b9e2e</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescriptionLanguageCode</key>
            <value>en</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>PaymentProviderID</key>
            <value>202</value>
        </data>
</specificPaymentData>
<paymentAccount>
    <specificPaymentAccountData>
        <data xsi:type="keyStringValuePair">
            <key>CardNumber</key>
            <value>373400000002221</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>CardVerificationCode</key>
            <value>012</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>ExpiryMonth</key>
            <value>06</value>
        </data>
        <data xsi:type="keyIntValuePair">
            <key>ExpiryYear</key>
            <value>2032</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>HolderName</key>
            <value>Barry Allen</value>
        </data>
    </specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>

Response success samples:

Example initiatePaymentResponse (ECMC Deposit - state AuthorisedByProvider):

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentResponse
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <paymentMethod>
            <key>1</key>
            <value>ECMC Deposit</value>
        </paymentMethod>
        <merchantTransactionID>ab0278d1-c891-459d-9314-c6bd3ced01a3</merchantTransactionID>
        <paymentID>1329b1c7-f57c-4f25-a3ab-98f95ec3dfd1</paymentID>
        <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
        <paymentProvider>
            <key>202</key>
            <value>Kushki</value>
        </paymentProvider>
        <amount currencyCode="MXN">45.88</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>0f6eb02d-9082-42c7-a63e-44ab3741c071</id>
            <definition>
                <key>13</key>
                <value>AuthorisedByProvider</value>
            </definition>
            <createdOn>2025-06-20T12:09:49.5534874Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseCode</key>
                    <value>0</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>Approved or completed successfully</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ApprovalCode</key>
                    <value>000000</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">2.72</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>Token</key>
                <value>13447cc290884f31b42ec421d9b4e351</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>508504254073823639</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>201734</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>6db3fb2a-c6af-4d14-a267-95997f30f212</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>MaskedNumber</key>
                    <value>545195******5480</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountOwnerToken</key>
                    <value>78e8aa28-5f81-4c65-9423-fd9232086564</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryMonth</key>
                    <value>6</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryYear</key>
                    <value>2032</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>HolderName</key>
                    <value>Barry Allen</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>CardType</key>
                    <value>Mastercard</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Example initiatePaymentResponse (Visa Deposit - state AuthorisedByProvider):

<initiatePaymentResponse
    xmlns="http://www.cqrpayments.com/PaymentProcessing"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <paymentMethod>
            <key>2</key>
            <value>VISA Deposit</value>
        </paymentMethod>
        <merchantTransactionID>1111141</merchantTransactionID>
        <paymentID>77b9d942-efa4-49ff-8549-1deb002e6c12</paymentID>
        <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
        <paymentProvider>
            <key>202</key>
            <value>Kushki</value>
        </paymentProvider>
        <amount currencyCode="MXN">15.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>55207c8f-5d85-4332-a033-52339849649d</id>
            <definition>
                <key>13</key>
                <value>AuthorisedByProvider</value>
            </definition>
            <createdOn>2025-06-20T12:11:57.281902Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseCode</key>
                    <value>0</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>Approved or completed successfully</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ApprovalCode</key>
                    <value>000000</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">0.89</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>Token</key>
                <value>c0e97a7e7e6c4c22ba4c424cc2a34a7a</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>741918217340875500</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>201735</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>1cc29a56-e64c-4599-bb51-11d9ee96a8ff</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerCountry</key>
                    <value>AT</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountFundingSource</key>
                    <value>Credit</value>
                </detail>
                <detail xsi:type="keyBooleanValuePair">
                    <key>FastFunds</key>
                    <value>false</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerName</key>
                    <value></value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Example initiatePaymentResponse (AMEX Deposit - state AuthorisedByProvider):

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoMerchant</shopID>
        <paymentMethod>
            <key>113</key>
            <value>AMEXDeposit</value>
        </paymentMethod>
        <merchantTransactionID>20250624000000</merchantTransactionID>
        <paymentID>17cf9b3d-67b9-483b-a1d1-a12fdd53bde5</paymentID>
        <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
        <paymentProvider>
            <key>202</key>
            <value>Kushki</value>
        </paymentProvider>
        <amount currencyCode="MXN">30.99</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>f6d8956a-73e9-4b8a-a29c-2ff38c56bfb1</id>
            <definition>
                <key>13</key>
                <value>AuthorisedByProvider</value>
            </definition>
            <createdOn>2025-06-24T11:30:54.7343913Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseCode</key>
                    <value>0</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>Approved or completed successfully</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ApprovalCode</key>
                    <value>000000</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">1.84</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>Token</key>
                <value>7e4071f561bc40fa8127d67d434736f0</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>615765102634821481</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>203078</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>8f5e1e4d-1a19-4a4c-88f9-05730245cb9f</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerCountry</key>
                    <value>US</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountFundingSource</key>
                    <value>Credit</value>
                </detail>
                <detail xsi:type="keyBooleanValuePair">
                    <key>FastFunds</key>
                    <value>false</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerName</key>
                    <value>AMERICAN EXPRESS US CONSUMER</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>MaskedNumber</key>
                    <value>373400*****2221</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountOwnerToken</key>
                    <value>ab13836e-12ca-4108-895f-593003aca3e5</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryMonth</key>
                    <value>6</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryYear</key>
                    <value>2032</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>HolderName</key>
                    <value>Barry Allen</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>CardType</key>
                    <value>AmericanExpress</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Response error/refusal samples:

Example initiatePaymentResponse (state InitiatePaymentAccountTokenErrorReportedByProvider):

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <paymentMethod>
            <key>1</key>
            <value>ECMC Deposit</value>
        </paymentMethod>
        <merchantTransactionID>ab0278d1-c891-459d-9314-c6bd3ced01a3</merchantTransactionID>
        <paymentID>6829ceab-26f7-41e0-9d8d-e0b6b3adff88</paymentID>
        <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
        <paymentProvider>
            <key>202</key>
            <value>Kushki</value>
        </paymentProvider>
        <amount currencyCode="MXN">45.88</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>3beaa143-ba99-43b3-a92c-6b79286599bd</id>
            <definition>
                <key>551</key>
                <value>InitiatePaymentAccountTokenErrorReportedByProvider</value>
            </definition>
            <createdOn>2025-06-20T12:06:38.5254517Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderErrorResponseCode</key>
                    <value>K006</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderErrorResponseMessage</key>
                    <value>DFR029 - Bin de tarjeta inválido</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">2.72</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>201733</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>0cdc94f6-1e85-4611-b68e-0fda7899e684</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>MaskedNumber</key>
                    <value>555555******4444</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountOwnerToken</key>
                    <value>75a5c231-e161-4ee8-9355-6d8202d89791</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryMonth</key>
                    <value>6</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryYear</key>
                    <value>2032</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>HolderName</key>
                    <value>Barry Allen</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>CardType</key>
                    <value>Mastercard</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Testcard number: 4574441215190335/5555555555554444

Example initiatePaymentResponse (state InitiatePaymentAccountTokenCommunicationErrorOccurred):

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <paymentMethod>
            <key>2</key>
            <value>VISA Deposit</value>
        </paymentMethod>
        <merchantTransactionID>1111141</merchantTransactionID>
        <paymentID>85f33cf1-a876-4c46-a97f-bd242b92ae6e</paymentID>
        <userID>761805d4-8274-4710-a5ac-7f4bbec37255</userID>
        <paymentProvider>
            <key>202</key>
            <value>Kushki</value>
        </paymentProvider>
        <amount currencyCode="MXN">15.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>090c1c9e-fe47-47b0-83c3-9e91475c7960</id>
            <definition>
                <key>549</key>
                <value>InitiatePaymentAccountTokenCommunicationErrorOccurred</value>
            </definition>
            <createdOn>2025-06-20T13:30:50.1436365Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">0.89</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>201760</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>1cc29a56-e64c-4599-bb51-11d9ee96a8ff</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerCountry</key>
                    <value>AT</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountFundingSource</key>
                    <value>Credit</value>
                </detail>
                <detail xsi:type="keyBooleanValuePair">
                    <key>FastFunds</key>
                    <value>false</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerName</key>
                    <value></value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Example initiatePaymentResponse (state RefusedByProvider):

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>B2BTestMerchant</merchantID>
        <shopID>KushkiProviderShop</shopID>
        <paymentMethod>
            <key>2</key>
            <value>VISA Deposit</value>
        </paymentMethod>
        <merchantTransactionID>111114211</merchantTransactionID>
        <paymentID>6ee52a9d-c5cb-41af-afd1-b4955afcf69b</paymentID>
        <userID>111111</userID>
        <paymentProvider>
            <key>202</key>
            <value>Kushki</value>
        </paymentProvider>
        <amount currencyCode="COP">350.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>80.121.151.158</userIP>
        <state>
            <id>182feb81-2667-404a-adbb-9c3568894044</id>
            <definition>
                <key>100</key>
                <value>RefusedByProvider</value>
            </definition>
            <createdOn>2022-08-18T11:59:35.1765433Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseCode</key>
                    <value>6</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>Error</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">0.14</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>Token</key>
                <value>38f618baf19c4831a4e7d605bf51f958</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2630</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>75929a10-c3b8-4f0d-a63a-82d135ec91e1</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerCountry</key>
                    <value>EC</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountFundingSource</key>
                    <value>Credit</value>
                </detail>
                <detail xsi:type="keyBooleanValuePair">
                    <key>FastFunds</key>
                    <value>false</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>IssuerName</key>
                    <value>UNKNOWN</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Notifications

The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.

Payment StatesDescription
AuthorisedByProviderSuccess state
RefusedByProviderPayment has been rejected by the provider.
AuthoriseErrorReportedByProviderPayment has an error reported by the provider.
AuthoriseCommunicationErrorOccurredA communication error has occurred

Example handlePaymentStateChangedNotificationRequest (state RefusedByProvider):

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
	<payment xsi:type="paymentWithPaymentAccount">
		<merchantID>DemoMerchant</merchantID>
		<shopID>DemoShop</shopID>
		<paymentMethod>
			<key>1</key>
			<value>ECMC Deposit</value>
		</paymentMethod>
		<merchantTransactionID>7fd84823-325f-4c24-9160-b3f537ad3857</merchantTransactionID>
		<paymentID>9462b4f7-2617-4eb9-a85c-51f71608c462</paymentID>
		<userID>54fd76c3-459b-4a30-8e82-9c0716</userID>
		<paymentProvider>
			<key>202</key>
			<value>Kushki</value>
		</paymentProvider>
		<amount currencyCode="COP">106.0200</amount>
		<creationType>
			<key>1</key>
			<value>User</value>
		</creationType>
		<userIP>127.0.0.1</userIP>
		<state>
			<id>4b2e6d7c-788f-4de9-9843-e88a4bf037db</id>
			<definition>
				<key>100</key>
				<value>RefusedByProvider</value>
			</definition>
			<createdOn>2022-08-02T12:38:45.953</createdOn>
			<paymentStateDetails>
				<detail xsi:type="keyStringValuePair">
					<key>ProviderErrorResponseCode</key>
					<value>017</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>ProviderErrorResponseMessage</key>
					<value>Invalid card</value>
				</detail>
				<detail xsi:type="keyIntValuePair">
					<key>PaymentStateReasonID</key>
					<value>1</value>
				</detail>
			</paymentStateDetails>
		</state>
		<isExecuted>false</isExecuted>
		<baseAmount currencyCode="EUR">0.0400</baseAmount>
		<paymentDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderExternalID</key>
				<value>1</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>Token</key>
				<value>7d658056-8bce-407d-a564-2de922fac446</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ElectronicCommerceIndicator</key>
				<value>07</value>
			</detail>
		</paymentDetails>
		<paymentAccount>
			<paymentAccountID>44c0fd9b-b3a7-48f0-85f6-065a0aecee27</paymentAccountID>
			<details>
				<detail xsi:type="keyStringValuePair">
					<key>IssuerCountry</key>
					<value>AT</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>AccountFundingSource</key>
					<value>Debit</value>
				</detail>
				<detail xsi:type="keyBooleanValuePair">
					<key>FastFunds</key>
					<value>false</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>IssuerName</key>
					<value>Some Bank</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>MaskedNumber</key>
					<value>526624******6818</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>AccountOwnerToken</key>
					<value>acda11b6-3410-4a8b-bb84-59b26943bf0a</value>
				</detail>
				<detail xsi:type="keyIntValuePair">
					<key>ExpiryMonth</key>
					<value>4</value>
				</detail>
				<detail xsi:type="keyIntValuePair">
					<key>ExpiryYear</key>
					<value>2030</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>HolderName</key>
					<value>Pepe Alonso</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>CardType</key>
					<value>Mastercard</value>
				</detail>
			</details>
		</paymentAccount>
	</payment>
</handlePaymentStateChangedNotificationRequest>

Example handlePaymentStateChangedNotificationRequest (state AuthorisedByProvider):

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
	<payment xsi:type="paymentWithPaymentAccount">
		<merchantID>DemoMerchant</merchantID>
		<shopID>DemoShop</shopID>
		<paymentMethod>
			<key>2</key>
			<value>VISA Deposit</value>
		</paymentMethod>
		<merchantTransactionID>1d609ff7-2d84-4bde-8ef7-965fc5ba6dfa</merchantTransactionID>
		<paymentID>7e537a99-0558-40ed-908f-5383632bd648</paymentID>
		<userID>cb385eaf-16a0-4e44-943c-994232</userID>
		<paymentProvider>
			<key>202</key>
			<value>Kushki</value>
		</paymentProvider>
		<amount currencyCode="COP">104.0100</amount>
		<creationType>
			<key>1</key>
			<value>User</value>
		</creationType>
		<userIP>127.0.0.1</userIP>
		<state>
			<id>9b377ef2-3ca1-43f2-b097-7ee1673fb21b</id>
			<definition>
				<key>13</key>
				<value>AuthorisedByProvider</value>
			</definition>
			<createdOn>2022-08-02T12:37:07.297</createdOn>
			<paymentStateDetails>
				<detail xsi:type="keyStringValuePair">
					<key>ApprovalCode</key>
					<value>000000</value>
				</detail>
			</paymentStateDetails>
		</state>
		<isExecuted>true</isExecuted>
		<baseAmount currencyCode="EUR">0.0400</baseAmount>
		<paymentDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderExternalID</key>
				<value>1</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderTransactionID</key>
				<value>8906365111</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>Token</key>
				<value>e40f59ef-9104-454c-998e-c703d034b593</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ElectronicCommerceIndicator</key>
				<value>07</value>
			</detail>
		</paymentDetails>
		<paymentAccount>
			<paymentAccountID>900edaf5-a594-4790-b372-93953235ccee</paymentAccountID>
			<details>
				<detail xsi:type="keyStringValuePair">
					<key>IssuerCountry</key>
					<value>AT</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>AccountFundingSource</key>
					<value>Credit</value>
				</detail>
				<detail xsi:type="keyBooleanValuePair">
					<key>FastFunds</key>
					<value>false</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>IssuerName</key>
					<value />
				</detail>
			</details>
		</paymentAccount>
	</payment>
</handlePaymentStateChangedNotificationRequest>

Test Data (provider)

Card NumberResultState
4349003000047015Transaction refused by KushkiRefusedByProvider
5451951574925480Successful transactionAuthorisedByProvider
4574441215190335Card number refused by KushkiInitiatePaymentAccountTokenErrorReportedByProvider
5555555555554444Card number refused by KushkiInitiatePaymentAccountTokenErrorReportedByProvider