1. Online Payments
  • API Docs Chile 🇨🇱
  • Online Payments
    • Release Notes
    • Kushki API errors
    • ISO errors
    • Card Payments
      • Request a card token
      • Make a charge or deferred charge
      • Create payment (tokenless)
      • Void a transaction
      • Refund a transaction
      • Request deferred options
      • Authorize payments
      • Preauthorization (tokenless)
      • Reauthorize payments
      • Capture an authorized payment
      • Verify Account
      • Validate OTP
      • Bin Info V2
      • Bin Info
      • Voucher
    • One-Click & Scheduled Payments
      • Request a recurring charge token
      • Create a recurring charge
      • Update recurring charge card data
      • Make an One-click payment
      • Cancel a recurring charge
      • Update a recurring charge
      • Add a temporary charge or discount
      • Authorize payments
      • Capture an authorized payment
      • Get recurring charge Info
    • Card Async
      • Request a card async token
      • Init Transaction
      • Authorize payments
      • Capture an authorized payment
      • Get Status
    • Async Card Recurring Charges
      • Request an async card recurring charge token
      • Init an async card recurring charge
      • Authorize payments
      • Capture an authorized payment
    • Chargebacks
      • Query Chargebacks
      • Request Chargeback Export
    • Transfer In
      • Get Bank List
      • Request a Transfer In token
      • Init Transaction
      • Get Status
    • Transfer Out
      • Get Bank List
      • Get Bank List V2
      • Request a Transfer Out token
      • Init Transaction
      • Get Status
      • Balance for Payouts
    • Cash In
      • Request a cash in token
      • Init Transaction
      • Transaction Status
    • Smartlinks V2
      • Create a Smartlink
      • Get a Smartlink
      • Delete a smartlink
      • Update a Smartlink
    • Payment Button
      • Create a payment button
    • Analytics
      • Get transactions list v1
      • Get transactions list v2
    • Status
      • Get platform status
      • Get gateway status
    • Subscription Transactions
      • Get subscription transactions
    • Payment Credentials
      • Create a credential
      • Search credentials
      • Update credential
      • Regenerate a credential
      • Delete credential
      • Activate or deactivate
      • Advanced search
    • Settlement
      • Query settlement
  • API Raw Card Present Payments 🇨🇱
    • Release Notes
    • Error Catalog
    • Test Data
    • Key Exchange Process
    • The Amount Object
    • One-time payments
      • Single payment
    • Two-step-payments
      • Authorization and capture
    • Voids & Refunds
      • Refund a transaction
      • Void & Reverse
    • Card information
      • Get BIN Info
      • Bin Info V2
      • Request deferred options
    • Query Transactions
      • Transaction Search
    • Chargebacks
      • Query Chargebacks
      • Request Chargeback Export
    • Webhooks
      • Introduction
      • Good practices
      • Refunds
      • Card Payments
      • Check your webhooks
  • Kushki One
    • Error Catalog
    • Release notes
    • Transaction Examples
    • Webhooks
    • Cloud Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Search
          • Transaction Search
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
      • Print
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Search
          • Transaction Search — Online
          • Transaction Search — Local
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
          • Abort (Async)
      • Print
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • Appian - Submerchant Register
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Submerchant Document Upload
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • RequestBodies
      • one-and-two-step-payment
    • documentType
    • Amount-cash-in
    • amount
    • Card
    • ChargebackListResponse
    • Channel
    • StatusComponent
    • SubscriptionTransactionsResponse
    • SettlementDateRangeRequest
    • TransactionResponse
    • PrintJobRequest
    • FraudAlertRequest
    • one-and-two-step-payment-1
    • one-and-two-step-payment-1
    • Card Present (CP)
    • networkToken
    • extra_taxes
    • ChargebackItem
    • SubscriptionTransaction
    • RawResponse
    • CommandText
    • FraudAlertResponse
    • Card Not Present (CNP)
    • webhooks
    • card
    • Amount-CL
    • webhooksItem
    • ErrorResponse400
    • SettlementResponse
    • CardData
    • CommandColumns
    • FraudAlertRecord
    • headers
    • currency
    • Amount
    • card_details
    • ErrorResponse401
    • SettlementRecord
    • LinkFailure
    • ColumnItem
    • ValidationError
    • transactionType
    • enc_tlv
    • ErrorResponse403
    • ErrorResponse
    • CommandDivider
    • TransactionEvent
    • extraTaxes
    • Country
    • binInfo
    • Deferred
    • deferred
    • ErrorResponse500
    • payment_method
    • CommandFeed
    • TransactionStatus
    • SubscriptionUpdate
    • pos_details
    • CommandSpace
    • ReadingType
    • ContactDetails
    • Language
    • contact_details
    • sub_merchant
    • CommandCut
    • FailureReason
    • Subscription
    • metadata
    • CommandImage
    • EventTerminal
    • orderDetails
    • TransactionSearchRequest
    • CommandQR
    • EventOperation
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • EventAmount
    • Billing-Address
    • EventExtraTaxes
    • PrintJobAccepted
    • PrinterError
    • EventMetadata
    • threeDomainSecure
    • SubscriptionAdjustmentRequest
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • webhooksChargeback
    • AmountCore
    • ExtraTaxes
    • PrintWebhookPayload
    • Metadata
    • citMit
    • AmountWithTip
    • network
    • TransactionSearchBody
    • TransactionSearchOnlineBody
    • AmountWithOptionalTip
    • TransactionSearchLocalBody
    • messageFields
    • TransactionEvent_2
    • UnexpectedErrorResponse
    • FailureReason_2
    • EventTerminal_2
    • ExternalReferenceId
    • EventOperation_2
    • ExternalSubscriptionId
    • EventAmount_2
    • EventExtraTaxes_2
    • EventMetadata_2
    • product
    • SettlementTicketRequest
    • TransactionEvent_21
    • TransactionStatus2
    • ReadingType3
    • FailureReason_24
    • EventTerminal_25
    • EventOperation_26
    • EventAmount_27
    • EventMetadata_28
    • EventExtraTaxes_29
    • PrintWebhookPayload10
    • TransactionEvent11
    • FailureReason12
    • EventTerminal13
    • EventOperation14
    • EventAmount15
    • EventMetadata16
    • EventExtraTaxes17
    • TransactionEvent_22
    • TransactionStatus3
    • ReadingType4
    • FailureReason_25
    • EventTerminal_26
    • EventOperation_27
    • EventAmount_28
    • EventMetadata_29
    • EventExtraTaxes_210
    • PrintWebhookPayload11
    • TransactionEvent12
    • FailureReason13
    • EventTerminal14
    • EventOperation15
    • EventAmount16
    • EventMetadata17
    • EventExtraTaxes18
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. Online Payments

ISO errors

This Error Catalog only applies to Kushki Acquiring Model, available for Colombia, Chile, Mexico, and Peru.
The field isoErrorCode is returned in declined single charges, preauthorizations, one-click charges when the fullResponse is set to v2 and could be returned either by the Card franchises or processors.
Note

In case it has a value of 228 corresponds to an internal decline of Kushki.
In case this code comes from the Card franchises (Visa, Mastercard or Prosa), it will have two digits. Below you will find the most common error codes:

Mastercard#

ISO Error CodeDescription
00Approved or completed successfully
01Refer to card issuer
03Invalid merchant
04Capture card
05Do not honor
08Honor with ID
10Partial Approval
12Invalid transaction
13Invalid amount
14Invalid card number
15Invalid issuer
30Format error
41Lost card
43Stolen card
51Insufficient funds/over credit limit
54Expired card
55Invalid PIN
57Transaction not permitted to issuer/cardholder
58Transaction not permitted to acquirer/terminal
61Exceeds withdrawal amount limit
62Restricted card
63Security violation
65Exceeds withdrawal count limit OR Identity Check Soft-Decline of EMV 3DS Authentication (merchant should resubmit authentication with 3DSv1)
70Contact Card
71Issuer PIN Not Changed
75Allowable number of PIN tries exceeded
76Invalid/nonexistent “To Account” specified
77Invalid/nonexistent “From Account” specified
78Invalid/nonexistent account specified (general)
79Life cycle (Mastercard use only for 0110 messages)
81Domestic Debit Transaction Not Allowed (Regional use only)
82Policy (Mastercard use only for 0110 messages)
83Fraud/Security (Mastercard use only for 0110 messages)
84Invalid Authorization Life Cycle
85Not declined Valid for all zero amount transactions.
86PIN Validation not possible
87Purchase Amount Only, No Cash Back Allowed
88Cryptographic failure
89Unacceptable PIN— Transaction Declined— Retry
91Authorization System or issuer system inoperative
92Unable to route transaction
94Duplicate transmission detected
96System error

Visa#

ISO Error CodeDescription
00Approval and completed successfully Accepted and processed
01Refer to card issuer
02Refer to card issuer, special condition
03Invalid merchant
04Pick up card (no fraud)
05Do not honor
06Error
07Pick up card, special condition (fraud account)
10Partial Approval
11Approved
12Invalid transaction
13Either Invalid amount or Currency conversion field overflow
14Either invalid card number, No modulus 10 check, not a valid length for issuer or not in positive PIN Verification file l Separator in wrong position
15No such issuer (first 8 digits of account number do not relate to an issuing identifier)
19Re-enter transaction
21No action taken
25Unable to locate record in file
28File is temporarily unavailable for update or inquiry
39No credit account
41Lost card, pick up card (fraud account)
43Stolen card, pick up (fraud account)
46Closed account
51Not sufficient funds
52No checking account
53No savings account
54Expired card or expiration date missing
55PIN incorrect or missing
57Used by switch when function requested is not allowed for product or card type
58Transaction not allowed at terminal
59Suspected fraud
61Exceeds approval amount limit
62Restricted card (card invalid in region or country)
63Security violation (source not correct issuer)
64Transaction does not fulfill AML requirement
65Exceeds withdrawal frequency limit
70PIN data required
74Different value than that used for PIN encryption errors
75Allowable number of PIN-entry tries exceeded
76Unsolicited reversal-reversal with no original transaction in history. V.I.P. unable to match reversal request to an original message
78Blocked, first used or special condition—new cardholder not activated or card is temporarily blocked
79Reversed (by switch)
80No financial impact (used in reversal responses to declined originals)
81Cryptographic error found in PIN (used for cryptographic error condition found by security module during PIN decryption)
82Negative online CAM, dCVV, iCVV, CVV, CAVV, dCVV2, TAVV, or DTVV results or Offline PIN authentication interrupted
85No reason to decline a request for address verification, CVV2 verifi- cation, or credit voucher or merchandise return
86Cannot verify PIN; for instance, no PVV
91Issuer unavailable or switch inoperative (STIP not applicable or available for this transaction). Time-out when no STIP. Credit voucher and merchandise return authorizations: V.I.P. sent transaction to issuer, but issuer unavailable. Acquirers receiving code must send transactions again. Advices not created. Issuers can respond with this code, which V.I.P. passes to the acquirer without invoking STIP. Issuers use code to indicate they cannot perform authorization on issuer’s behalf.Causes decline at POS.
92Financial institution or intermediate network facility cannot be found for routing (receiving institution ID invalid)
93Transaction cannot be completed- violation of law.
94Duplicate transmission. Transaction submitted containing values in tracing data fields that duplicate values in a previously submitted transaction.
96System malfunction
1AAdditional customer authentication required
6PVerification data failed
B1Surcharge amount not permitted on Visa cards or EBT food stamps (U.S. acquirers only)
N0Force STIP. Issuers can respond with this, which routes transactions to STIP. Issuers use code when they cannot perform authorization but want STIP to perform it.
N3Cash service not available
N4Cash request exceeds issuer or approved limit
N7Decline for CVV2 failure
N8Transaction amount exceeds pre- authorized approval amount
P5Denied PIN unblock-PIN change or unblock request declined by issuer
P6Denied PIN change-requested PIN unsafe
Q1Card authentication failed or Offline PIN authentication interrupted
R0Stop payment order
R1Revocation of authorization order
R2Transaction does not qualify for Visa PIN
R3Revocation of all authorizations order
Z3Unable to go online; offline-declined

Prosa#

ISO Error CodeDescription
00Approved or completed successfully
01Refer to card issuer
02Refer to special conditions for card issuer
03Invalid merchant
04Pick-up card
05Do not honor
06Error
07Pick-up card, special condition
09Request in progress (duplicate)
10Approved partial
11Approved (VIP) *
12Invalid transaction
13Invalid amount
14Invalid card number (no such number)
15No such issuer
30Format error
31Bank not supported by switch
33Expired card
34Suspected fraud
35Card acceptor contact acquirer
36Restricted card
37Card acceptor call acquirer security
38Allowable PIN tries exceded
39No credit account
41Lost card
43Stolen card, pick-up
51Not sufficient funds
54Expired card
55Incorrect personal identification number *
56No card record
57Transaction not permitted to cardholder
58Transaction not permitted to terminal
61Exceeds withdrawal amount limit
62Restricted card
65Exceeds withdrawal frequency limit
75Allowable number of PIN tries exceeded *
76Reserved for private use or Approved country club *
77Reserved for private use or Approved pending identification (sign paper draft)*
78Reserved for private use or Approved blind *
79Reserved for private use or Approved administrative transaction *
80Reserved for private use or Approved national negative file hit OK *
81Reserved for private use or Approved commercial *
82Reserved for private use or No security module
83Reserved for private use or No accounts
84Reserved for private use or No PBF *
85Reserved for private use or PBF update error *
86Reserved for private use or Invalid authorization type
87Reserved for private use or Bad Track Data
88Reserved for private use or PTLF error *
89Reserved for private use or Invalid route service
91Cutoff is in process, a switch is ending business for a day and starting the 90 next (transaction can be sent again in a few minutes) Issuer or switch is inoperative
92Financial institution or intermediate network facility cannot be found for routing
94Duplicate transmission
96System malfunction
N0Reserved for private use or Unable to authorize
N1Reserved for private use or Invalid PAN length
N2Reserved for private use or Preauthorization full
N3Reserved for private use or Maximum online refund reached
N4Reserved for private use or Maximum offline refund reached
N5Reserved for private use or Maximum credit per refund
N6Reserved for private use or Maximum refund credit reached
N7Reserved for private use or Customer selected negative file reason
N8Reserved for private use or Over floor limit
N9Reserved for private use or Maximum number refund credits
O0Reserved for private use or Referral file full
O1Reserved for private use or NEG file problem *
O2Reserved for private use or Advance less than minimum
O3Reserved for private use or Delinquent
O4Reserved for private use or Over limit table
OSReserved for private use or PIN required *
O6Reserved for private use or Mod 10 check
O7Reserved for private use or Force post
O8Reserved for private use or Bad PBF *
O9Reserved for private use or NEG file problem *
P0Reserved for private use or CAF problem *
P1Reserved for private use or Over daily limit *
P2Reserved for private use or CAPF not found *
P3Reserved for private use or Advance less than minimum
P4Reserved for private use or Number of times used
PSReserved for private use or Delinquent
P6Reserved for private use or Over limit table
P7Reserved for private use or Advance less than minimum
P8Reserved for private use or Administrative card needed
P9Reserved for private use or Enter lesser amount
Q0Reserved for private use or Invalid transaction date
Q1Reserved for private use or Invalid expiration date
Q2Reserved for private use or Invalid transaction code
Q3Reserved for private use or Advance less than minimum
Q4Reserved for private use or Number of times used
Q5Reserved for private use or Delinquent
Q6Reserved for private use or Over limit table
Q7Reserved for private use or Amount over maximum
Q8Reserved for private use or Administrative card not found
Q9Reserved for private use or Administrative card not allowed
R0Reserved for private use or Approved administrative request performed in window *
R1Reserved for private use or Approved administrative request performed out of window *
R2Reserved for private use or Approved administrative request performed anytime *
R3Reserved for private use or Chargeback, customer file updated
R4Reserved for private use or Chargeback, customer file updated, acquirer not found
R5Reserved for private use or Chargeback, incorrect prefix number
R6Reserved for private use or Chargeback, incorrect response code or CPF configuration
R7Reserved for private use or Administrative transactions not supported
R8Reserved for private use or Card on national negative file *
S4PTLF full *
S5Reserved for private use or Chargeback approved, customer file not updated
S6Reserved for private use or Chargeback approved, customer file not updated, acquirer not found
S7Reserved for private use or Chargeback accepted, incorrect destination
S8Reserved for private use or ADMN file problem
S9Reserved for private use or Unable to validate PIN; security module is down *
T1Reserved for private use or Invalid credit card advance amount
T2Reserved for private use or Invalid transaction date
T3Reserved for private use or Card not supported
T4Reserved for private use or Amount over maximum
T5Reserved for private use or CAF status = 0 or 9 *
T6Reserved for private use or Bad UAF *
T7Reserved for private use or Cash back exceeds daily limit
T8Reserved for private use or Invalid account
U0ARQC failure decline *
U1Security module parameter error *
U2Security module failure *
U3KEY1 record not found *
U4ATC check failure *
U5CVR decline *
U6TVR decline *
U7Reason online code decline *
U8Fallback decline *
V0ARQC failure referral *
V1CVR referral *
V2TVR referral *
V3Reason online code referral *
V4Fallback referral *
V7ARQC failure capture *
V8CVR capture *
V9TVR capture *
40Command rejected
R9Destination not available
17Customer cancellation
22Suspected malfunction
S0Suspect reversal
68Response received too late
64Original amount incorrect
S1Suspicious reversal override
S2Misdispense reversal
95Reconcile error
Modified at 2026-08-31 21:30:59
Previous
Kushki API errors
Next
Card Payments
Built with