Card and Response Codes

When a card transaction fails or is declined, DPO Pay by Network returns a response code that explains what happened.

These codes help merchants identify the cause — whether it’s insufficient funds, expired cards, network issues, or other conditions.

How to use these codes

Each transaction includes a ResponseCode and message in the API or on your transaction report. Use the table below to understand what the code means and the recommended merchant or customer action.

CodeMeaningRecommended Action
00Approved or completed successfullyNo action required. Transaction successful.
01Refer to card issuerAsk the customer to contact their bank.
04Pick up cardDeclined; retain the card if possible.
05Do not honourDeclined. Ask the customer to use another payment method.
12Invalid transactionCheck the transaction type and data submitted.
14Invalid card numberConfirm the card number or try another card.
30Format errorVerify the request format matches DPO’s integration specification.
41Lost cardDeclined. Advise the customer to contact their bank.
43Stolen cardDeclined. Customer must contact issuer.
51Insufficient fundsCustomer should use another card or retry later.
54Expired cardAsk the customer to use a valid card.
57Transaction not permitted to cardholderCustomer’s bank has blocked the transaction type.
61Exceeds withdrawal limitCustomer has reached their card’s limit.
91Issuer or switch inoperativeTemporary issue. Try again later.
96System malfunctionRetry later. If repeated, contact DPO Support.

See this page for all the response codes.

📘

Response codes may vary depending on the acquirer and card network. Refer to your integration API for the complete list.

Common decline reasons

  • Incorrect CVV or expiry date.
  • Customer’s card issuer declined due to fraud suspicion.
  • Insufficient funds or exceeded limits.
  • Network timeout or communication issue.

Where to view response codes

  • In the Merchant Portal, under Transactions → Details.
  • In API responses, look for ResponseCode and ResponseDescription.
  • In the settlement or reconciliation report CSV.