Payout retries

Overview

There are many reasons for payouts to be declined, for example because of reaching the daily limit for payouts in the payment system or unavailability of the payment system (provider) service. In this case, an option to retry payout within the same payment procedure may come in handy; this functionality is available in the ecommpay platform.

The payout retry functionality is available for all payment methods: both for card payments and for payments by using other payment instruments. The payment platform can automatically issue retries—until payout is successfully completed or after a certain number of retry attempts is reached—or technical support specialists may issue retries manually.

Specifics and limitations

There are several things you need to consider when issuing payment retries:

  • Retries are available only for the payouts initiated after the retry functionality is enabled for the project.

    There is no way to issue retry for payouts initiated before enabling the retry functionality—neither automatically nor manually. In this situation, to complete the payment, you need to initiate a new payment with a different payment ID (payment_id).

  • Currently, retry is possible for payouts declined with the following reasons:

    • The payment system (provider) unavailability or response timeout has occurred. Response codes: 314, 601, 10505, 10602, 20202 and 20602.
    • Daily amount limit or daily payment number limit is reached. Response codes: 3317–3319, 3320–3322, 3335, 3336–3340, 3450 and 20101.
    • The payment system (provider) declined the payout with no specific reason. Response codes: 10000, 10100, 20000 and 20100.

    To get the most recent information about decline reasons for which retry is possible, contact your ecommpay account manager or technical support (support@ecommpay.com); for response code details, see Information of operations performing.

  • The actual time between consecutive retries may insignificantly differ from the time specified in the configuration.

Setup and configuration

To enable the payout retry functionality, you need to coordinate with your ecommpay key account manager, and then contact the ecommpay technical support (support@ecommpay.com) for assistance.

The standard allowed limits for automatic retries is as follows: 12 payout retries with at least one-hour delay between the retries. If required, these limits may be changed within certain ranges; contact technical support for details of these ranges.

Workflow

When payout retry functionality is enabled payouts follow the standard procedure: the web service submits a payout request to the payment platform through Gate, and then the request is processed and forwarded to the payment system (provider) service. If the payout is successfully completed, the payment platform sends a callback with the resulting payment status—success—to the web service; if the payout is declined, the payment platform checks whether retry is possible for the current decline code and, if yes, sends out a callback with the awaiting retry payment status, otherwise callback contains the decline status.

The awaiting retry payment status is preserved between the retries and is reassigned to the payment each time a successive retry is declined, provided the retry number limit is not reached. Once the retry number limit is reached, the payment is declined and assigned the final decline status.

Irrespective of the way used to initiate payout retry—automatically or manually, the merchant is not notified about every single retry attempt. The payment platform submits a callback to merchant's web service only if payment is assigned a final status (success or decline). Also, Dashboard displays only retry attempts that resulted in a final payment status. At any point, you can check a payment status by submitting a separate payment status request. (For details, see Checking current payment information)

Related topics

The following topics might be useful when using payout retry functionality: