Understanding Response Codes

When you process a payment, myPOS returns a response code that tells you what happened. These codes follow the ISO 8583 standard and help you know if a payment was successful or why it failed.

Tip: Use response codes to show clear messages to your customers and handle payments correctly.

Response Code Categories

Response codes are grouped into four main types:

  • Approved: The transaction was successful.
  • Declined: The transaction was rejected.
  • Call Issuer: The customer should contact their bank.
  • Capture/Retry: Special handling is needed.

Common Response Codes

Here are the codes you’ll see most often:

Successful Transactions

CodeTypical MeaningTypeWhat to Do
00Approved or completed successfullyApprovedComplete the order
08Honor with IDApprovedComplete the order (ID checked)
10Partial ApprovalApprovedComplete with the approved amount
85Not declined (for zero-amount transactions)ApprovedAccept the transaction

Declined Transactions

CodeTypical MeaningTypeWhat to Do
05Do not honorDeclinedTransaction declined by the bank
51Insufficient funds or over credit limitDeclinedAsk the customer to use a different card
54Expired cardDeclinedAsk the customer to use a valid card
55Invalid PINDeclinedCustomer entered the wrong PIN
12Invalid transactionDeclinedTransaction cannot be processed
13Invalid amountDeclinedCheck the transaction amount
14Invalid card numberDeclinedCustomer entered the wrong card number
57Transaction not permittedDeclinedCard not allowed for this type of transaction
61Exceeds withdrawal limitDeclinedAmount is too high for this card
62Restricted cardDeclinedCard has restrictions
63Security violationDeclinedSecurity check failed
65Exceeds withdrawal countDeclinedToo many transactions today
75Too many PIN attemptsDeclinedCustomer is locked out
81Transaction not allowedDeclinedCard not valid in this region

Contact Bank

CodeTypical MeaningTypeWhat to Do
01Refer to card issuerCall IssuerAsk the customer to call their bank
70Contact card issuerCall IssuerAsk the customer to call their bank

Special Cases

CodeTypical MeaningTypeWhat to Do
41Lost cardSpecialCard reported lost — do not process
43Stolen cardSpecialCard reported stolen — do not process
91System temporarily unavailableSpecialTry again later
94Duplicate transaction detectedSpecialCheck if already processed
96System errorSpecialContact support if this keeps happening

Technical Errors

CodeTypical MeaningTypeWhat to Do
03Invalid merchantTechnicalCheck your merchant setup
15Invalid issuerTechnicalCard issuer not recognized
30Format errorTechnicalCheck your request parameters
76Invalid "To Account"TechnicalCheck account details
77Invalid "From Account"TechnicalCheck account details
78Invalid accountTechnicalCheck account details
84Invalid authorization lifecycleTechnicalAuthorization expired or invalid
86PIN validation not possibleTechnicalCannot verify PIN
87No cashback allowedTechnicalOnly purchase amount is allowed
88Cryptographic failureTechnicalSecurity verification failed
89Unacceptable PINTechnicalPIN format is incorrect
92Unable to routeTechnicalCannot process transaction