HTTP Status and Case Code

Successful responses are indicated with a 200-series HTTP code and a JSON-based payload containing the object(s) requested, created, modified, or deleted along with an expression of the server’s interpretation of your request.

Error responses are served with a non-200-series HTTP code. Different error and case codes indicate different reasons for an error.

1. Virtual Account

HTTP Status Code	Case Code	Response Message	Description
400XX	00	Bad Request	General request failed error, including message parsing failed.
400XX	01	Invalid Field Format {field name}	Invalid format
400XX	02	Invalid Mandatory Field {field name}	Missing or invalid format on mandatory field
401XX	00	Unauthorized. [reason]	General unauthorized error (No Interface Def, API is Invalid, Oauth Failed, Verify Client Secret Fail, Client Forbidden Access API, Unknown Client, Key not Found)
401XX	01	Invalid Token ( B2B )	Token found in request is invalid (Access Token Not Exist, Access Token Expiry)
401XX	03	Token Not Found (B2B	Token not found in the system. This occurs on any API that requires token as input parameter

2. Credit Card

Payment Response Code

Response Code	Description	Category
00	Approved or completed successfully	Issuer approved
01	Refer to card issuer, Contact card issuer	Generic response codes
02	Refer to card issuer - Special conditions	Generic response codes
03	Invalid merchant	Issuer cannot approve at this time
04	Pick up card (no fraud)	Issuer will never approve
05	Do not honor	Generic response codes
06	Error (applies for VISA)	Generic response codes
07	Pickup card, special conditions (applies for VISA)	Issuer will never approve
08	Honor with ID (applies for VISA)	Issuer approved
10	Partial value approved	Generic response codes
11	Approved V.I.P (applies for MASTERCARD)	Issuer approved
12	Invalid transaction	Issuer will never approve
13	Invalid value/amount	Generic response codes
14	Invalid card number	Issuer will never approve
15	No such issuer	Issuer will never approve
19	Re-enter transaction (applies for VISA)	Issuer cannot approve at this time
21	No action taken (applies for VISA)	Generic response codes
25	Unable to locate record on file (applies for VISA)	Generic response codes
28	File is temporarily unavailable (applies for VISA)	Generic response codes
30	Format error (applies for MASTERCARD)	Generic response codes
39	No credit account (applies for VISA)	Issuer cannot approve at this time
41	Lost card - pick up	Issuer will never approve
43	Stolen card - pick up	Issuer will never approve
46	Closed Account (applies for VISA)	Issuer will never approve
51	Insufficient funds	Issuer cannot approve at this time
52	No checking account (applies for VISA)	Issuer cannot approve at this time
53	No savings account (applies for VISA)	Issuer cannot approve at this time
54	Expired card	Issuer cannot approve based on details provided
55	Incorrect PIN	Issuer cannot approve based on details provided
57	Transaction not permitted to cardholder	Issuer will never approve
58	Transaction not permitted to terminal	Generic response codes
59	Suspected fraud	Issuer cannot approve at this time
61	Exceeds withdrawal amount limits	Issuer cannot approve at this time
62	Restricted card	Issuer cannot approve at this time
63	Security Violation	Issuer cannot approve based on details provided
64	Transaction does not fulfill AML requirement (applies for VISA)	Generic response codes
65	Exceeds withdrawal frequency limit	Issuer cannot approve at this time
70	Contact Card Issuer (applies for MASTERCARD)	Issuer cannot approve at this time
70	PIN data required (applies for VISA)	Issuer cannot approve based on details provided
71	PIN not changed (applies for MASTERCARD)	Issuer cannot approve at this time
74	Different value than that used for PIN encryption errors	Generic response codes
75	Allowable PIN tries exceeded	Issuer cannot approve at this time
76	Invalid/nonexistent “To Account” specified (applies for MASTERCARD)	Generic response codes
76	Unsolicited reversal (applies for VISA)	Generic response codes
77	Invalid/nonexistent “From Account” specified (applies for MASTERCARD)	Generic response codes
78	Blocked card, first time card usage (applies for VISA)	Issuer cannot approve at this time
78	Invalid/nonexistent account specified (applies for MASTERCARD)	Generic response codes
79	Life Cycle (applies for MASTERCARD)	Generic response codes
79	Already reversed by Switch (applies for VISA)	Generic response codes
80	Credit issuer unavailable (applies for MASTERCARD)	Generic response codes
80	No financial impact (applies for VISA)	Generic response codes
81	Domestic Debit Transaction Not Allowed (applies for MASTERCARD)	Generic response codes
81	Cryptographic error found in PIN (applies for VISA)	Generic response codes
82	Negative CAM, dCVV, iCVV, or CVV results (applies for VISA)	Issuer cannot approve based on details provided
82	Policy (applies for MASTERCARD)	Generic response codes
83	Fraud/Security (applies for MASTERCARD)	Generic response codes
84	Invalid Authorization Life Cycle (applies for MASTERCARD)	Generic response codes
85	No reason to decline	Issuer approved
86	Cannot verify PIN	Issuer cannot approve at this time
87	Purchase amount only, no cash back allowed (applies for MASTERCARD)	Issuer approved
88	Cryptographic failure (applies for MASTERCARD)	Generic response codes
89	Unacceptable PIN (applies for MASTERCARD)	Generic response codes
89	Ineligible to receive financial position information (applies for VISA)	Generic response codes
90	Cutoff is in progress (applies for MASTERCARD)	Generic response codes
91	Issuer or switch is inoperative	Issuer cannot approve at this time
92	Destination cannot be found for routing	Generic response codes
93	Transaction cannot be completed - violation of law (applies for VISA)	Issuer cannot approve at this time
94	Duplicate transmission / invoice	Generic response codes
96	System malfunction	Issuer cannot approve at this time
1A	Authentication required (applies for VISA)	Issuer cannot approve based on details provided
6P	Verification data failed (applies for VISA)	Generic response codes
B1	Surcharge amount not permitted (applies for VISA)	Generic response codes
B2	Surcharge amount not supported by debit network issuer (applies for VISA)	Generic response codes
N0	Force STIP (applies for VISA)	Generic response codes
N3	Cash service not available (applies for VISA)	Issuer cannot approve at this time
N4	Cash request exceeds issuer or approved limit (applies for VISA)	Issuer cannot approve at this time
N5	Ineligible for resubmission (applies for VISA)	Generic response codes
N7	Decline for CVV2 failure (applies for VISA)	Issuer cannot approve based on details provided
N8	Transaction amount exceeds preauthorized approval amount (applies for VISA)	Generic response codes
P5	Denied PIN unblock (applies for VISA)	Generic response codes
P6	Denied PIN change (applies for VISA)	Generic response codes
Q1	Card Authentication failed (applies for VISA)	Generic response codes
R0	Stop Payment Order (applies for VISA)	Issuer will never approve
R1	Revocation of authorization order (applies for VISA)	Issuer will never approve
R2	Transaction does not qualify for Visa PIN (applies for VISA)	Generic response codes
R3	Revocation of all authorizations order (applies for VISA)	Issuer will never approve
Z3	Unable to go online (applies for VISA)	Generic response codes
1Z	Authorization System or issuer system inoperative (applies for MASTERCARD)	Generic response codes

Category Guide

1. Issuer will never approve : This subset of decline codes indicates there is no circumstance in which the issuer will approve.

   Recommended action: do not try again.

2. Issuer cannot approve at this time : This subset of decline codes indicates the issuer may approve, but cannot do so at that time.

   Recommended action: try again later.

3. Issuer cannot approve based on details provided : This subset of codes indicates the issuer cannot approve based on the details provided.

   Recommended action: provide updated or additional information.

4. Generic response codes : and other decline codes not listed, many of which are not explained by the issuers, fall in this category and re-attempt is allowed.

   Recommended action: try again later

3. e-Wallet

ShopeePay

HTTP Status Code	Case Code	Error Message
400XX	00	Bad Request
400XX	01	Invalid Field Format {{param}}
400XX	02	Invalid Mandatory Field {{param}}
401XX	00	Unauthorized {param}
401XX	01	Invalid Token B2B
401XX	02	Invalid customer Token
401XX	03	Token not found B2B
401XX	04	Customer token not found
403XX	00	Transacction Expired
403XX	01	Feature Not Allowed
403XX	02	Exceeds Transaction Amount Limit
403XX	03	Suspected Fraud
403XX	04	Activity Count Limit Exceeded
403XX	05	Do Not Honor"
403XX	06	Feature Not Allowed At This Time
403XX	07	Card Blocked
403XX	08	Card Expired
403XX	09	Dormant Account
403XX	10	Need To Set Token Limit
403XX	11	OTP Blocked
403XX	12	OTP Lifetime Expired
403XX	13	OTP Sent To Cardholder
403XX	14	Insufficient Funds
403XX	15	Transaction Not Permitted.
403XX	16	Suspend Transaction
403XX	17	Token Limit Exceeded
403XX	18	Inactive Card/Account/Customer
403XX	19	Merchant Blacklisted
403XX	20	Merchant Limit Exceed
403XX	21	Set Limit Not Allowed
403XX	22	Token Limit Invalid
403XX	23	Account Limit Exceed
404XX	00	Invalid Transaction Status
404XX	01	Transaction Not Found
404XX	02	Invalid Routing
404XX	03	Bank Not Supported By Switch
404XX	04	Transaction Cancelled
404XX	05	Merchant Is Not Registered For Card Registration Services
404XX	06	Need To Request OTP
404XX	07	Journey Not Found
404XX	08	Invalid Merchant
404XX	09	No Issuer
404XX	10	Invalid API Transition
404XX	11	Invalid Card/Account/Customer [info]/Virtual Account
404XX	12	Invalid Bill/Virtual Account
404XX	13	Invalid Amount
404XX	14	Paid Bill
404XX	15	Invalid OTP
404XX	16	Partner Not Found
404XX	17	Invalid Terminal
404XX	18	Inconsistent Request
404XX	19	Invalid Bill/Virtual Account
405XX	00	Requested Function Is Not Supported
405XX	01	Requested Operation Is Not Allowed
409XX	00	Conflict
409XX	01	Duplicate partnerReferenceNo
429XX	00	Too Many Requests
500XX	00	General Error
500XX	01	Internal Server Error
500XX	02	External Server Error
504XX	00	Timeout

DANA

HTTP Status Code	Case Code	Error Message
200XX	00	Successful
400XX	00	Bad Request
400XX	01	Invalid Field Format {field name}
400XX	02	Invalid Mandatory Field {field name}
401XX	00	Unauthorized. [reason]
401XX	01	Invalid Token (B2B)
401XX	02	Invalid Customer Token
401XX	04	Customer Token Not Found
403XX	02	Exceeds Transaction Amount Limit
403XX	05	Do Not Honor
403XX	14	Insufficient Funds
403XX	15	Transaction Not Permitted.[reason]
404XX	00	Invalid Transaction Status
404XX	01	Transaction Not Found
404XX	08	Invalid Merchant
404XX	12	Invalid Bill/Virtual Account [Reason]
404XX	13	Invalid Amount
404XX	18	Inconsistent Request
429XX	00	Too Many Requests
500XX	00	General Error
500XX	01	Internal Server Error

OVO

HTTP Status Code	Case Code	Error Message
200XX	00	Successful
400XX	00	Bad Request
400XX	01	Invalid Field Format {field name}
400XX	02	Invalid Mandatory Field {field name}
401XX	00	Unauthorized. [reason]
401XX	01	Invalid Token (B2B)
401XX	02	Invalid Customer Token
401XX	04	Customer Token Not Found
403XX	02	Exceeds Transaction Amount Limit
403XX	05	Do Not Honor
403XX	14	Insufficient Funds
403XX	15	Transaction Not Permitted.[reason]
404XX	00	Invalid Transaction Status
404XX	01	Transaction Not Found
404XX	08	Invalid Merchant
404XX	12	Invalid Bill/Virtual Account [Reason]
404XX	13	Invalid Amount
404XX	18	Inconsistent Request
429XX	00	Too Many Requests
500XX	00	General Error
500XX	01	Internal Server Error

4. Direct Debit

Allobank

HTTP Status Code	Case Code	Error Message
200XX	00	Successful
400XX	00	Bad Request
400XX	01	Invalid Field Format {field name}
400XX	02	Invalid Mandatory Field {field name}
401XX	00	Unauthorized. [reason]
401XX	01	Invalid Token (B2B)
401XX	02	Invalid Customer Token
401XX	04	Customer Token Not Found
403XX	02	Exceeds Transaction Amount Limit
403XX	05	Do Not Honor
403XX	14	Insufficient Funds
403XX	15	Transaction Not Permitted.[reason]
404XX	00	Invalid Transaction Status
404XX	01	Transaction Not Found
404XX	08	Invalid Merchant
404XX	12	Invalid Bill/Virtual Account [Reason]
404XX	13	Invalid Amount
404XX	18	Inconsistent Request
429XX	00	Too Many Requests
500XX	00	General Error
500XX	01	Internal Server Error

CIMB

HTTP Status Code	Case Code	Error Message
200XX	00	Successful
400XX	00	Bad Request
400XX	01	Invalid Field Format {field name}
400XX	02	Invalid Mandatory Field {field name}
401XX	00	Unauthorized. [reason]
401XX	01	Invalid Token (B2B)
401XX	02	Invalid Customer Token
401XX	04	Customer Token Not Found
403XX	02	Exceeds Transaction Amount Limit
403XX	05	Do Not Honor
403XX	14	Insufficient Funds
403XX	15	Transaction Not Permitted.[reason]
404XX	00	Invalid Transaction Status
404XX	01	Transaction Not Found
404XX	08	Invalid Merchant
404XX	12	Invalid Bill/Virtual Account [Reason]
404XX	13	Invalid Amount
404XX	18	Inconsistent Request
429XX	00	Too Many Requests
500XX	00	General Error
500XX	01	Internal Server Error

BRI

HTTP Status Code	Case Code	Error Message
200XX	00	Successful
400XX	00	Bad Request
400XX	01	Invalid Field Format {field name}
400XX	02	Invalid Mandatory Field {field name}
401XX	00	Unauthorized. [reason]
401XX	01	Invalid Token (B2B)
401XX	02	Invalid Customer Token
401XX	04	Customer Token Not Found
403XX	02	Exceeds Transaction Amount Limit
403XX	05	Do Not Honor
403XX	14	Insufficient Funds
403XX	15	Transaction Not Permitted.[reason]
404XX	00	Invalid Transaction Status
404XX	01	Transaction Not Found
404XX	08	Invalid Merchant
404XX	12	Invalid Bill/Virtual Account [Reason]
404XX	13	Invalid Amount
404XX	18	Inconsistent Request
429XX	00	Too Many Requests
500XX	00	General Error
500XX	01	Internal Server Error