Payment Method Management

To improve collection rates, it’s essential to use the correct payment method at the right time. Ensuring customers can easily identify the payment method is crucial, especially when multiple payment methods are stored and used.

Addressing invalid payment methods promptly is also critical to maintain a high collection rate. Any billing attempt using an invalid payment method will fail, so it’s important to resolve these issues quickly. Ezypay's auto rebill feature will stop once a payment method is identified as invalid. Ezypay helps identify invalid payment methods through the following:

payment_method_invalid webhook event.
paymentMethodInvalid field in Ezypay's invoice payload

When an invalid payment method is detected, inform the customer immediately. They must provide an new payment method and replace the existing before billing can continue. You will be able to retry on the invoice once this is done.

View Saved Payment Method

Customers should have the ability to view their saved payment methods and easily identify which one is currently in use. Due to the sensitivity of full payment details, Ezypay provides truncated information for most payment methods, except for PayTo and wallet payments. For more information on the payment methods data provided by the APIs, refer to the Ezypay guide.

Table below outlines the minimum expectations for displaying a payment method:

Payment method type	Minimum information to display
CARD	card type, last 4 digit of card number and expiry date
BANK	bank number and last 4 digit of account number
PAYTO	Dependent on PayTo account type: `BBAN`: BSB number and bank account number `ALIA`: Either phone number or email address
WALLET	Wallet type and mobile number.

Delete Saved Payment Method

Customer may not want their payment method to be saved if they are not using it anymore. Provide the control for customer to remove the payment method in your application. Any payment method deleted will have its PAN data removed from our Vault Environment.

Replace Payment Method

Customers should have the option to replace their payment method in the following scenarios:

The current payment method has become invalid, and a new one is required.
The customer prefers to use a different payment method for billing.

Use Ezypay's replace payment method API to replace an old payment method with a new one. This action will update all invoices and subscriptions associated with the old method to the new one.

Set Default Payment Method

Customers should have the ability to select their default payment method. Allowing them to choose the payment method reduces the likelihood of failed payments and improves collection rates.

Ezypay treats the primary payment method as the default, automatically using it for billing if none is specified. When a payment method is replaced, the new method becomes the primary, which updates across all subscriptions and invoices. If you only wish to update the primary payment method without altering subscriptions or invoices, update the payment method instead of replacing it. You can identify the primary payment method stored by Ezypay using retrieve the primary payment method API.