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

Apart from Acquirer's Response Code, There's also response code generated by DOKU in case if transaction failed due to any validation before being processed to acquirer

Acquirer Response Code

ECode	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

DOKU Error Code

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

OVO

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

BRI

5. QRIS

Generate QR

HTTP Status Code	Case Code	Error Messages
200XX	00	Request has been processed successfully
400XX	01	Invalid Field Format (name_field)
400XX	02	Invalid Mandatory Field (name_field)
401XX	00	Unauthorized . Signature Not Match
401XX	00	Unauthorized . Unknown Client
401XX	01	Access Token Invalid (B2B)
404XX	08	Invalid Merchant
404XX	18	Inconsistent Request
409XX	00	Conflict

Decode QR

Payment QR

Query QR

Refund QR

6. Kirim DOKU

Account Inquiry

HTTP Code	Response Code	Response Message	Description	Status
200	2004200	Successful	Successful	Success
400	4004200	Bad Request	General request failed error, including message parsing failed.	Failed
400	4004201	Invalid Field Format {Field}	Invalid format. For example caused by: Invalid currency code Amount is filled with non numerical values etc	Failed
400	4004202	Invalid Mandatory Field {Field}	Missing mandatory fields. For example caused by: Field amount does not exist in the request Field senderCountryCode does not exist in the request Field beneficiaryAccountNumber does not exist in the request etc	Failed
401	4014200	Unauthorized. [reason]	General unauthorized error. E.g. invalid X-SIGNATURE, X-TIMESTAMP, X-PARTNER-ID, X-EXTERNAL-ID, or Authorization.	Failed
401	4014201	Invalid Token (B2B)	Token found in request in invalid	Failed
403	4034201	Feature Not Allowed [reason]	E.g. Forex setting has not been set	Failed
403	4034202	Exceeds Transaction Amount Limit	Contact the administrator. Check the range of amount in sub channel, or fee settings.	Failed
403	4034206	Feature Not Allowed At This Time	Ongoing cut off time	Failed
404	4044200	Invalid Transaction Status	Invalid transaction status	Failed
404	4044202	Invalid Routing	Invalid routing	Failed
404	4044203	Bank Not Supported By Switch	Contact the administrator. Check sub channel or route bank settings.	Failed
404	4044208	Invalid Merchant	May be caused by: The partner does not exist or is no longer active. Agent key not found	Failed
404	4044211	Invalid Card/Account/Customer [info]/Virtual Account	Beneficiary account numbers may be invalid, inactive, or not found.	Failed
404	4044212	Invalid Bill/Virtual Account	The bill is blocked/suspended/not found	Failed
404	4044219	Invalid Bill/Virtual Account	The bill is expired (VA Payment)	Failed
409	4094200	Conflict	Cannot use the same X-EXTERNAL-ID in the same day	Failed
429	4294200	Too Many Requests	Caused by beneficiary account number has failed inquiry 4 times in the past 2 hours.	Failed
500	5004200	General Error	Contact the administrator. Check partner settings in the back office. E.g. forex settings	Failed
500	5004201	Internal Server Error	Unknown internal server failure. Please retry the inquiry process.	Failed
500	5004202	External Server Error	E.g. system failure	Failed
504	5044200	Timeout	Timeou	Failed

Balance Inquiry

Transfer Bank

Check Status