Failure Reason/eWallet Error

Below is the list of common error and failure codes in eWallet payment, void, and refund.

Error Codes for eWallet Charge Endpoint

Error Code	Error Message
API_VALIDATION_ERROR 400	There is invalid input in one of the required request fields
UNSUPPORTED_CURRENCY 400	The payment currency request is not supported for this payment channel. Please refer to our API reference or docs to pick available currencies
INVALID_PAYMENT_METHOD_ID 400	There is a mismatch between the requested channel_code or customer_id against the values used during creation of the specified payment_method_id. Or that the payment_method_id does not exist in this account. Please retry with a valid payment_method_id
INVALID_API_KEY 401	API key format is invalid
INVALID_MERCHANT_CREDENTIALS 401	Merchant credentials met with an error with the eWallet provider. Please contact Xendit customer support to resolve this issue
INVALID_TOKEN 401	Account linking token for this end user has expired. Please reinitiate account linking before retrying.
REQUEST_FORBIDDEN_ERROR 403	The API key is forbidden to perform this request
CHANNEL_NOT_ACTIVATED 403	Payment request failed because this specific payment channel has not been activated through Xendit. Please activate via Xendit dashboard or our customer service
CALLBACK_URL_NOT_FOUND 404	Payment request failed because there was no input of callback url in Xendit Dashboard or request headers. Please save your callback url in Xendit Dashboard
UNSUPPORTED_CONTENT_TYPE 403	The content type requested is not supported
CHARGE_LIMIT_EXCEEDED 429	Maximum of 3 request attempts to Jenius Pay per cashtag within a span of 10 minutes has been exceeded. Please wait for 10 minutes before trying to initiate a new request
SERVER_ERROR 500	An unexpected error occured, our team has been notified and will troubleshoot the issue
CHANNEL_UNAVAILABLE 503	The payment channel requested is currently experiencing unexpected issues. The eWallet provider will be notified to resolve this issue

Failure Codes for eWallet Charge Endpoint

Failure Code	Failure Message
ACCOUNT_ACCESS_BLOCKED	End user’s account cannot be accessed as it has been restricted by the eWallet provider. End user should contact the provider for resolution
INVALID_MERCHANT_CREDENTIALS	Merchant credentials met with an error with the eWallet provider. Please contact Xendit customer support to resolve this issue
USER_DECLINED_PAYMENT	End user declined the payment request
INVALID_ACCOUNT_DETAILS	End user provided incorrect information for this transaction
MAXIMUM_LIMIT_REACHED	Accumulated value of payment requested for this end user went above the maximum transaction limit set by end user or eWallets. Payment can be retried when the transaction limit is reset
USER_UNREACHABLE	End user’s device cannot be reached at this moment. Common reasons include unstable network, device error or jailbroken device
CHANNEL_UNAVAILABLE	The payment channel requested is currently experiencing unexpected issues. The eWallet provider will be notified to resolve this issue
INSUFFICIENT_BALANCE	End user has insufficient balance to complete the transaction
ACCOUNT_NOT_ACTIVATED	End user’s account cannot be accessed as it has not been activated. End user should set up their account and ensure there is sufficient balance before retrying
INVALID_TOKEN	Binding for this end user has expired. Please reinitiate binding before retrying
FAILURE_DETAILS_UNAVAILABLE	Details related to the failed payment request were not provided by the eWallet provider

Error Codes for Void eWallet Payment Endpoint

Error Code	Error Message
API_VALIDATION_ERROR 400	There is an error with the format submitted to the server
VOID_NOT_SUPPORTED 400	Void feature is not available as the method is not provided by eWallet provider
VOID_TEMPORARILY_UNAVAILABLE 400	Void feature is unavailable between 00:00:00 and 05:00:00 UTC+07:00/UTC+08:00 each day for ShopeePay transactions. Please try again after 05:00:00 UTC+07:00/UTC+08:00
INVALID_API_KEY 401	API key format is invalid
REQUEST_FORBIDDEN_ERROR 403	The API key is forbidden to perform this request
INELIGIBLE_TRANSACTION 403	Payment has already passed its void validity period (after 23:50:00 UTC+07:00/UTC+08:00) for requested operation or status of charge is not SUCCEEDED
INELIGIBLE_MERCHANT 403	Merchant has a settlement configuration that is not eligible for voiding transactions. Please contact Xendit customer support for resolution
DATA_NOT_FOUND 404	Resource not found. Please check your query again
SERVER_ERROR 500	An unexpected error occured. Our team has been notified and will troubleshoot the issue
CHANNEL_UNAVAILABLE 503	The payment channel requested is currently experiencing unexpected issues. The eWallet provider will be notified to resolve this issue

Failure Codes for Void eWallet Payment Endpoint

Failure Code	Failure Message
MAXIMUM_USER_BALANCE_EXCEEDED	Void could not be processed because the amount returned will cause end user's wallet balance to exceed maximum allowable value

Error Codes for Refund eWallet Payment Endpoint

Error Code	Error Message
API_VALIDATION_ERROR 400	There is an error with the format submitted to the server
MAXIMUM_REFUND_AMOUNT_REACHED 400	Requested refund amount cannot exceed remaining unrefunded amount of the successful charge
MAXIMUM_REFUND_TRANSACTION_REACHED 400	You have reached the maximum refund transactions allowed for this charge. Kindly check the refund limitations for all eWallet channels here https://docs.xendit.co/ewallet/payment-flows/void-and-refund#refund-ewallet-charge
PARTIAL_REFUND_NOT_SUPPORTED 400	Partial refund feature is not available as the method is not provided by the eWallet provider
REFUND_TEMPORARILY_UNAVAILABLE 400	Refund feature is unavailable between 23:50:00 and 05:00:00 UTC+07:00/UTC+08:00 each day for ShopeePay transactions. Please try again after 05:00:00 UTC+07:00/UTC+08:00
REFUND_TEMPORARILY_UNAVAILABLE 400	Partial refund feature is not available for Maya (PayMaya) on the day of transaction. Please try again after 23:59:59 of transaction day
REFUND_NOT_SUPPORTED 400	Refund feature is not available as the method is not provided by the eWallet provider
REFUND_IN_PROGRESS 400	Concurrent refund requests to a single eWallet charge is not allowed. Please wait for the pending refund request to be completed before initiating a new one
INVALID_API_KEY 401	API key format is invalid
REQUEST_FORBIDDEN_ERROR 403	The API key is forbidden to perform this request
INELIGIBLE_TRANSACTION 403	Requested refund transaction cannot be processed as the transaction is in “FAILED”, “PENDING”, or “VOIDED” status
INSUFFICIENT_BALANCE 403	There is insufficient balance in your account to perform a refund. Please top up your balance with a sufficient amount before retrying the refund
DATA_NOT_FOUND 404	Resource not found. Please check your query again
SERVER_ERROR 500	An unexpected error occured. Our team has been notified and will troubleshoot the issue
CHANNEL_UNAVAILABLE 503	The payment channel requested is currently experiencing unexpected issues. The eWallet provider will be notified to resolve this issue

Failure Codes for Refund eWallet Payment Endpoint

Failure Code	Failure Message
INELIGIBLE_TRANSACTION	Transaction has already passed its validity period for the requested operation or the number of refunds requested has exceeded the allowable number of tries
INSUFFICIENT_BALANCE	Switcher account does not have sufficient balance to perform a refund. Please retry after ensuring there is sufficient balance in the switcher account
REFUND_TEMPORARILY_UNAVAILABLE	Refund is temporarily unavailable because of settlement constraints with the eWallet provider. Please try again later
MAXIMUM_USER_BALANCE_EXCEEDED	Refund could not be processed because the amount returned will cause end user's wallet balance to exceed maximum allowable value
INELIGIBLE_PARTIAL_REFUND_TRANSACTION	Transaction specified is not eligible for partial refund because of eWallet provider's limitations. You can retry refund by doing full refund. GrabPay doesn't allow partial refunds for transactions made under promos or using GrabPay points