API error codes for `/payment_requests` and `/payments`

Error Code	HTTP Error	Description
INACTIVE_PAYMENT_REQUEST	400	Payment request is already in its terminal state. Changes are no longer allowed.
INVALID_VALUE_ERROR	400	The API request format and parameters are correct. However, the values for one or more parameters are not within what is allowed by the payment channel or your settings.
API_VALIDATION_ERROR	400	The API request format or parameters do not follow our validations.
CARD_EXPIRED	400	The card expiry date in the request has already passed.
CAPTURE_AMOUNT_EXCEEDED	400	The capture amount specified in capture request must be less than or equal to the uncaptured authorization amount.
REFUND_AMOUNT_EXCEEDED	400	The refund amount specified in the refund request must be less than or equal to the capture amount that has not been refunded.
INVALID_PAYMENT_DETAILS	400	The payment information entered by the end user is invalid.
PAYMENT_REQUEST_RATE_LIMITED	400	Maximum number of requests to this payment channel has been exceeded in a given time frame.
INVALID_TOKEN	400	Payment token ID specified in the payment request has expired or has been canceled.
TEMPORARILY_UNAVAILABLE	400	Requested feature is unavailable during this timing. You can perform a retry later on.
PARTIAL_REFUND_COUNTS_EXCEEDED	400	Number of partial refunds has exceeded what is allowed by payment channel.
REFUND_IN_PROGRESS	400	There is a pending refund request. Please wait for the pending request to be completed before initiating a new one.
INELIGIBLE_TRANSACTION_STATUS	400	The operation requested is not available for the data resource in its current status.
INSUFFICIENT_BALANCE	400	There is insufficient balance in your account to perform a refund. Please top up your balance with a sufficient amount before retrying the refund.
BLOCKED_TOKEN	400	Payment token ID specified in the payment request was rejected by the payment channel.
INVALID_OTP	400	OTP specified is invalid.
EXPIRED_OTP	400	OTP specified has expired.
SKIP_3DS_FORBIDDEN	403	Non 3DS card payment requests is not allowed. A request to activate this feature is required.
INVALID_MERCHANT_SETTINGS	403	The merchant credentials used faced an error with the provider.
REFUND_NOT_SUPPORTED	403	Refund feature is not available for this payment channel.
PARTIAL_REFUND_NOT_SUPPORTED	403	Partial refund feature is not available for this payment channel.
VOID_NOT_SUPPORTED	403	Void feature is not available for this payment channel.
INELIGIBLE_MERCHANT_SETTINGS	403	Merchant settings configuration is not eligible for the request operation. Please contact Xendit customer support for resolution.
DATA_NOT_FOUND	404	The data resource requested does not exist in our system. This could be due to race conditions. Your system can introduce retries or implement a delay to avoid this error. Only visible to selected team account(s), reader(s), and/or security group(s)
DUPLICATE_ERROR	409	There is a uniqueness constraint blocking the request that you are sending.
UNSUPPORTED_CONTENT_TYPE	415	The content type requested is not supported
SERVER_ERROR	500	An unexpected error occurred, our team has been notified and will troubleshoot the issue.
CHANNEL_UNAVAILABLE	503	The payment channel requested is currently experiencing unexpected issues. The provider will be notified to resolve this issue.
ISSUER_UNAVAILABLE	503	The end user's payment method provider is currently experiencing unexpected issues. The provider will be notified to resolve this issue.

Failure codes for `/payment_requests` and `/payments`

Error Code	Description
ACCOUNT_ACCESS_BLOCKED	Payment failed because access to the user’s account has been blocked. Payment channel provider has to be contacted to provide specific reasons.
INVALID_MERCHANT_SETTINGS	Payment failed because payment channel has configured the wrong settings for this account.
INVALID_ACCOUNT_DETAILS	Payment failed because payment information provided by user is wrong.
PAYMENT_ATTEMPT_COUNTS_EXCEEDED	Payment failed because there has been too many attempts in a short period of time.
USER_DEVICE_UNREACHABLE	Payment failed because the payment channel was unable to reach the end user’s device.
CHANNEL_UNAVAILABLE	Payment channel was unable to provide a definitive response on whether payment has succeeded or not.
INSUFFICIENT_BALANCE	Payment failed because the end user does not have sufficient balance in their account.
ACCOUNT_NOT_ACTIVATED	Payment failed because the end user’s account has not been activated.
INVALID_TOKEN	Payment failed because the payment token has been invalidated or expired.
SERVER_ERROR	Payment failed due to unknown reasons. Xendit will investigate this issue immediately.
TIMEOUT_ERROR	Payment channel was unable to provide a definitive response because the connection to payment channel has timed out.
USER_DECLINED_PAYMENT	Payment failed because the end user declined payment.
USER_DID_NOT_AUTHORIZE	Payment failed because the end user did not authorize payment with the time limits.
PAYMENT_REQUEST_EXPIRED	Payment failed because the payment request has already expired.
FAILURE_DETAILS_UNAVAILABLE	Payment channel informed Xendit that the payment has failed without providing specific reasons.
EXPIRED_OTP	Payment failed because the OTP is passed its validity period.
INVALID_OTP	Payment failed because the wrong OTP has been entered.
PAYMENT_AMOUNT_LIMITS_EXCEEDED	Payment failed because the end user’s transaction limits has been exceeded.
OTP_ATTEMPT_COUNTS_EXCEEDED	Payment failed because there were too many OTP attempts.
CARD_DECLINED	Payment failed because the card used was declined for processing.
DECLINED_BY_ISSUER	Payment failed because the issuer has declined approval.
ISSUER_UNAVAILABLE	Payment failed because the issuer cannot be reached.
DECLINED_BY_PROCESSOR	Payment failed because the card used was declined for processing.
AUTHENTICATION_FAILED	Payment failed because authentication has failed.