How do I enable Success+?

To start using Success+, add retry_if_possible:true to all of your create payment, subscription and instalment schedule requests. This will mean that any eligible payments will be intelligently retried. Note that a merchant’s payments will only be eligible if they have enabled Success+ in the GoCardless dashboard.

How do I know which payments will be retried?

There are a number of criteria which determine whether a payment will be retried. Some of these are dynamic: i.e. when our model looks for a date to retry, it may consider that there is no appropriate date. This means you cannot predict which payments will be intelligently retried. Instead, you can use the will_attempt_retry flag which is on the payment:failed event. If this flag is set to true, then the payment will be intelligently retried. If not, then it is safe for you to retry the payment.

What do I do if a payment is going to be retried?

After any payment:failed event with will_attempt_retry:true, we will send a payment:resubmission_requested event. When you receive this event, you should call get payment to get the updated payment, including the new charge_date. You can treat this exactly the same as a manual user-triggered retry - the payment will be re-attempted on the new charge_date and will go through the normal payment flow. If you already support payment retries, there should be very limited work involved here.

What do I do if I don’t want a payment to be retried?

Sometimes, there may be a situation where a merchant wants to cancel a payment, but it is already in a submitted state. In this case, we recommend you call update payment with retry_if_possible:false. This means that, while the initial payment will still continue, it will not be automatically retried.

How do merchants enable and configure Success+?

Merchants should be directed to the GoCardless dashboard, to the link https://manage.gocardless.com/success-plus. This will allow them to enable and configure Success+.

What should I show the merchant?

  • Show the merchant how many times a payment has been retried (by keeping an attempt count)
  • Show the merchant the charge date of the current payment
  • Show the merchant how to get to the GoCardless dashboard to enable and configure Success+

What should I not show the merchant?

  • Don’t show a ‘Retry’ button when a payment is going to be intelligently retried - this action will fail in GoCardless and confuse the merchant.

How do I find out more?

Visit the API Reference for Success+ here.