Failed Payment Responses

When a payment fails, Ezypay will advise what the failed payment reason is against the customer's account. These failed payment response codes/reasons are provided by Ezypay's banking partner.

To help understand what each failed payment response code means and what actions are required to resolve a failed payment, below are the links to the failed payment response guides, per country and payment method.

The guides will provide a breakdown of the following and with explanation on what each columns are meant for.

Columns in failed response table	Description	Fields in API / webhook
Payment Response Code	This is the response code return by payment provider when a transaction failed.	`paymentProviderResponse[code]` • Webhook Event: “`Invoice_past_due`” • Retrieve Invoice API response • List Invoice API response • Retrieve Transaction API response • List Transaction API response
Payment Response	Generic failed payment reason for easy understanding what happened and what the next cause of action will be. Should be used to build any logic around the failed payment handling process in the application.	`failedPaymentReason[code]` • Webhook Event: “`Invoice_past_due`” • Retrieve Invoice API response • List Invoice API response • Retrieve Transaction API response • List Transaction API response
Subscription Invoice Status	Highlight what happened to the future invoice of a subscription, whether it will still continue billing (Active) or the billing is stopped (inactive). Note: Only applicable to integrators on subscription model.	Webhook Event: “`Subscription_payment_stopped`”
Invoice Status	Invoice status returned by Ezypay	`status` • Webhook Event: “`Invoice_past_due`” • Retrieve Invoice API response
Transaction Status	Transaction status returned by Ezypay	`status` • Retrieve Transaction API response • List Transaction API response
Payment Provider Response	A descriptive explanation on the “Payment Response Code” field. Provide a more drill down explanation on what happened at the payment provider.	`paymentProviderResponse[description]` • Webhook Event: “`Invoice_past_due`” • Retrieve Invoice API response • List Invoice API response • Retrieve Transaction API response • List Transaction API response
Payment Response Description	A descriptive explanation on the “Payment Response” field. A generic description on what could possibly happened and suggested actions.	`failedPaymentReason[description]` • Webhook Event: “`Invoice_past_due`” • Retrieve Invoice API response • List Invoice API response • Retrieve Transaction API response • List Transaction API response
Payment Method Status	A more detail explanation on what the responses mean and what could be the possible reasons for failed payments. Highlight on how Ezypay can deal with it.	`paymentMethodInvalid` • Webhook Event: “`Invoice_past_due`” • Retrieve Invoice API response True: Inactive False: Active
What it Means	A more detail explanation on what the responses mean and what could be the possible reasons for failed payments. Highlight on how Ezypay can deal with it.	N/A
Suggested Actions (For Integrators)	Some suggestion on what should be done by the integrators if they received the failed payment response.	N/A
Suggested Actions (For Merchants)	Some suggestion on what should be done by the merchants if they received the failed payment response.	N/A
Suggested Actions (For Customers)	Some suggestion on what should be done by the customers if they received the failed payment response.	N/A