Deferred payment

In contrast to the standard payment process with a bank card, a deferred payment is processed in two stages: first the money is placed on hold on the user's card, and then it is debited at your request. This payment method is also referred to as placing a hold, or pre-authorization.

Restriction. 

Only the payments made with bank cards may be deferred (paymentType=AC).

How to enable deferred payments

  1. Contact your Yandex.Checkout manager. The manager will explain the procedure and make the settings for your store.
  2. You will get separate shopId and scid parameters specifically for card payments. The shopId and scid will be different for all other payment types.
  3. Use the confirmPayment and cancelPayment methods to implement the two payment stages.

If you enable deferred payment, all card payments will be processed as deferred payments, in two stages.

Scenario from the store's viewpoint

1. Payment and reserving funds

  1. The user chooses payment with a bank card (on the store's website or in the Yandex.Checkout interface) and clicks Pay.
  2. The information that the user enters in the store's interface is transmitted to the Yandex.Checkout service.
  3. The user is directed to the confirmation page on the Yandex.Checkout website.
  4. The user enters the bank card information and confirms the payment.
  5. The amount is put on hold on the user's card. If the operation was successful, the user can't access this money.
  6. The user sees the result — a page with a message about successful payment, or a page with an error message.
  7. The results page displays a Back to store link. The user can click it to go to the page address that you entered in the settings or passed in the payment form.

  8. The merchant receives a reservation notification (paymentAviso). The store has 30 days to complete the order and confirm the payment (this period can be set individually). Alternatively, the store can cancel the order and the payment.

2. Debit or cancel

  • Store fulfills the order completely
    1. The store uses the confirmPayment method to confirm debiting the amount.
    2. And gets a response to the request.
    3. The reserved amount is debited from the user's bank card in the same way as for a normal payment. The store is charged a commission fee.
  • Store doesn't fulfill the order
    1. The store uses the cancelPayment method to cancel the order.
    2. The reserved amount is unblocked on the user's card, and the user can now access this money. The store is not charged a fee.
  • Store fulfills the order only partially (for example, delivers 3 out of 4 items).
    1. The store uses the confirmPayment method to confirm debiting the appropriate amount.
    2. The required amount is debited from the user's card. The remainder of the reserved amount is unblocked, and the user can now access it. The store is charged a commission fee only on the amount of the successful payment.
    3. The store receives notification that the money was debited successfully.
  • The hold expires. The money is unblocked and either becomes available to the user, or is debited in full (this depends on the store's settings).
Restriction. 

By default, a deferred payment holds the money for 7 days (this is standard for the Visa and MasterCard payment systems). After this time, the issuing bank can unblock the money at any time.

The hold can last up to 30 days on the Yandex.Money side, for all deferred payments at once. However, this does not affect the issuing bank. In 7 days, it will unblock the money in any case. If there isn't enough money available on the card at the time of payment confirmation (confirmPayment), the payment can't be made.

Sending details for the receipt

Note. 

This is only required if you set up interaction with your online sales register via Yandex.Checkout. See Description of payment process where data for the receipt are transmitted

1. Payment and reserving funds

When making deferred payments, data for the receipt are sent to online sales register on the first stage: if the bank card is successfully authorized.

2. Debit or cancel

At the second stage there may be several options:

  • The payment amount remains constant: the store confirms debiting using the confirmPayment method; the payment is executed as usual; the details for the receipt are sent on the first stage.
  • The payment amount is adjusted
    1. The store confirms debiting using the confirmPayment method; at that, the request includes the receipt parameter for a new receipt.
    2. We transmit a receipt for refund (in order to cancel the receipt that was sent on the first stage) to your online sales register.
    3. Then we transmit a new receipt with a new amount.

All in all, within one operation we transmit three receipts: initial operation receipt, cancel receipt, and receipt with a new amount.

  • Operation cancelled
    1. The store uses the cancelPayment method to cancel the order.

See also

confirmPayment method

cancelPayment method

Financial transactions