1. CARD PRESENT PAYMENTS (API RAW) Copy
English
  • Español
  • English
  • Bienvenidos
  • ONLINE PAYMENTS
    • CARD
      • 1. Request a card token
      • 2. Make a charge or deferred charge
      • 3. Void a transaction
      • 4. Refund a transaction
      • 5. Request deferred options
      • 6. Authorize payments
      • 7. Capture an authorized payment
      • 8. Bin Info
      • 9. Bin Info V2
      • 10. Validate OTP
      • 11. Voucher
      • 5. Request deferred options
      • 8. Bin Info
      • 10. Validate OTP
      • 3. Void a transaction
      • 4. Refund a transaction
      • 6. Authorize payments
      • 1. Request a card token
      • 7. Capture an authorized payment
      • 11. Voucher
      • 2. Make a charge or deferred charge
      • 9. Bin Info V2
    • CASH IN
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
    • TRANSFER IN
      • 1. Get Bank List
      • 2. Request a Transfer In token
      • 3. Init Transaction
      • 4. Get Status
      • 1. Get Bank List
      • 4. Get Status
      • 2. Request a Transfer In token
      • 3. Init Transaction
    • TRANSFER OUT
      • 1. Get Bank List
      • 2. Request a Transfer Out token
      • 3. Init Transaction
      • 4. Get Status
      • 5. Wallet Balance
      • 2. Request a Transfer Out token
      • 1. Get Bank List
      • 5. Wallet Balance
      • 3. Init Transaction
      • 4. Get Status
    • ONE-CLICK & SCHEDULED PAYMENTS
      • 1. Request a recurring charge token
      • 2. Create a recurring charge
      • 3. Update recurring charge card data
      • 4. Make an One-click payment
      • 5. Cancel a recurring charge
      • 6. Update a recurring charge
      • 7. Add a temporary charge or discount
      • 8. Authorize payments
      • 9. Capture an authorized payment
      • 10. Get recurring charge Info
      • 3. Update recurring charge card data
      • 7. Add a temporary charge or discount
      • 10. Get recurring charge Info
      • 5. Cancel a recurring charge
      • 6. Update a recurring charge
      • 4. Make an One-click payment
      • 9. Capture an authorized payment
      • 8. Authorize payments
      • 2. Create a recurring charge
      • 1. Request a recurring charge token
    • PAYMENT BUTTON
      • 1. Create a payment button
      • 1. Create a payment button
    • SMARTLINKS V2
      • 1. Create a Smartlink
      • 2. Get a Smartlink
      • 3. Delete a Smartlink
      • 4. Update a Smartlink
      • 3. Delete a Smartlink
      • 4. Update a Smartlink
      • 1. Create a Smartlink
      • 2. Get a Smartlink
    • PAYMENT CREDENTIALS
      • 1. Create a credential
      • 2. Search credentials
      • 3. Advanced search
      • 4. Activate or deactivate
      • 5. Delete credential
      • 6. Update credential
      • 7. Regenerate a credential
      • 6. Update credential
      • 5. Delete credential
      • 4. Activate or deactivate
      • 2. Search credentials
      • 1. Create a credential
      • 3. Advanced search
      • 7. Regenerate a credential
    • COMMISSIONS
      • 1. Get Commission Configuration
      • 1. Get Commission Configuration
    • GATEWAY STATUS
      • 1. Get gateway status
      • 1. Get gateway status
    • ANALYTICS
      • 1. Get transactions list
      • 1. Get transactions list
    • ASYNC CARD RECURRING CHARGES
      • 1. Request a token
      • 2. Init an async card recurring charge
      • 3. Authorize payments
      • 4. Capture an authorized payment
      • 2. Init an async card recurring charge
      • 4. Capture an authorized payment
      • 1. Request a token
      • 3. Authorize payments
    • CARD ASYNC
      • 1. Request a card async token
      • 2. Init Transaction
      • 3. Authorize payments Copy
      • 4. Capture an authorized payment Copy
      • 5. Get Status
      • 4. Capture an authorized payment Copy
      • 5. Get Status
      • 3. Authorize payments Copy
      • 2. Init Transaction
      • 1. Request a card async token
  • CARD PRESENT PAYMENTS (API RAW) Copy
    • error-catalog
    • Test data
    • One-time payments
      • Single payment
    • Two-step-payments
      • Authorization and capture
    • Voids & Refunds
      • Void & Reverse
      • Refund a transaction
    • Card information
      • Balance inquiries
      • Get BIN Info
      • BIN info V2
      • Request deferred options
    • Query Transactions
      • Transaction Search
Perú 🇵🇪APPIAN-SUBMERCHANT-REGISTERMéxico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱
Perú 🇵🇪APPIAN-SUBMERCHANT-REGISTERMéxico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱
  1. CARD PRESENT PAYMENTS (API RAW) Copy

Test data

To verify the possible error scenarios during card reading,, it is necessary to include the code that applies to the scenario you want to test in the amount field, as shown in the following example:
{
  "amount": {
    "iva": 10,
    "currency": "CLP",
    "extra_taxes": {
      "tip": 0
    }
  ...

}
When you send 10 in the amountfield (remember that this field corresponds to the sum of all values within the object), you will receive the following response:
{
 "F11": "101675",
 "cvm_type": "",
 "franchise": "MASTERCARD",
 "message_fields": {
   "F38": "892478",
   "F39": "10"
 },
 "kushki_response": {
   "code": "10",
   "message": "Approved partial"
 },
 "transaction_type": "charge",
 "authorized_amount": 100,
 "additional_amounts": {
   "amount": 0,
   "card_type": "",
   "amount_type": "",
   "account_type": "",
   "currency_code": ""
 },
 "transaction_status": "DECLINED",
 "transaction_reference": "0c598cc7-bfd5-4180-8544-34a4f923086e"
}
Note: Keep in mind that in the kushki_response field, you will be able to see the response of the test scenario
In the previous example, the response is shown below:
{
   "code": "10",
   "message": "Approved partial"
}

Card-Present payments#

Use the following test data to simulate different scenarios when integrating Card-Present Payments through the API.

🇨🇱 Chile#

Use these amounts to test transactions in the dev environment:
Amount (CLP)Error codeDescription
100001Transaction declined. Please contact your card issuer.
400004The entered card has been reported.
500005An error occurred while processing the transaction.
740000Approval (transaction approved with delay).
1740000Approval (transaction approved with delay). Note: Applies to void/reversal transactions.
Other—Send any other valid amount for an approved transaction.

🇵🇪 Peru and 🇲🇽 Mexico#

Use the following data to test the reception of card-present payments:
AmountTransaction TypeResponse CodeDescription
10Authorization01Transaction declined. Please contact your card issuer.
40Authorization04The entered card has been reported.
50Authorization05An error occurred while processing the transaction.
74Authorization00Approval (transaction approved with delay).
174Void/Reverse00Approval (transaction approved with delay).
Modified at 2026-04-16 14:01:18
Previous
error-catalog
Next
One-time payments
Built with