200

any

00

Successful

Transaction successful.

No action is needed.

400

any

01

Invalid / Missing Field Format {field name}

Invalid data format in field {field name}.

Check the API documentation for the correct format and adjust your request value.

400

any

02

Invalid Mandatory Field {field name}

Some mandatory parameters are missing or have an invalid format.

Ensure all mandatory fields are filled and follow the required format.

401

any

00

Unauthorized. [reason]

Authentication failed.

Check your API Key, Client ID, Client Secret, Signature, and API URL. Ensure all credentials are correct and active and that the signature generation process follows the required format.

401

any

01

Invalid Token (B2B)

The token used in the request is invalid or has expired.

Generate a new Access Token and include it properly in the Authorization header.

401

any

02

Invalid Customer Token

Invalid or expired customer token.

Ensure the customer token is obtained through a proper login process, is still active, and is used appropriately according to its purpose.

401

any

03

Token Not Found (B2B)

Token not found in the system.

Ensure the token used is valid, appropriately generated through the official process, corresponds to the correct environment (Sandbox or Production), and is not expired.

404

any

00

Invalid Transaction Status

The current transaction status is not appropriate for this process.

Ensure the transaction status is appropriate before proceeding with the action.

404

any

01

Transaction Not Found

Transaction not found.

Ensure the Order ID or related parameters are correct, generated from the transaction creation process, and appropriate for the API being used.

404

any

12

Invalid Bill / Virtual Account [Reason]

The Virtual Account (VA) number or bill is not found or blocked.

Ensure the Virtual Account (VA) number or bill number used is correct, still active, and has not been paid.

404

any

13

Invalid Amount.

The payment amount does not match the expected amount.

Ensure that the amount used matches the valid billing information retrieved from the inquiry process.

404

any

14

Bill has been paid

The bill has already been paid.

Check the transaction status. If the payment has already been successful, no further payment is required.

404

any

19

Invalid Bill / Virtual Account

The bill or Virtual Account used is no longer active.

Recreate the bill to continue with the payment process.

409

any

00

Conflict

A transaction with the same X-EXTERNAL-ID has already been processed today.

Use a different X-EXTERNAL-ID for new transactions or check the status of the previous transaction.

409

any

01

Duplicate partnerReferenceNo

A transaction with the same partnerReferenceNo has already been processed successfully.

Use a different partnerReferenceNo for new transactions, or check the existing transaction status first.

500

any

00

General Error

A general error occurred while processing the transaction.

Review the request format and network connection. If the issue persists, please contact Espay support for further assistance.

500

any

01

Internal Server Error

An internal error occurred while processing the transaction.

Please retry the process after a while. If the issue still occurs, contact Espay support for further assistance.

500

any

02

External Server Error

Backend system failure occurred while processing the transaction.

Please retry the process after a while. If the issue still occurs, contact Espay support for further assistance.

504

any

00

Timeout

Transaction requests to the bank or issuer are taking longer than usual.

Check the transaction status or retry the process if necessary. If the issue still occurs, contact Espay support for further assistance.