Installments
- Payment method type in the API:
installments
- Confirmation scenario: Redirect
- Payment term: 24 hours
- Holding: 6 hours
- Code in reports: CR
- Refund: yes, full and partial (with specifics)
- Refund processing time: instantly
- Recurring payments: no
- Limits: the minimum payment amount is 3,000 rubles, and the maximum amount is 150,000 rubles
Ready-made solutions: Smart payment
Manual integration: Payment via the Installments service
You can also embed a widget to display the monthly payment amounts.
Step 1. Create a payment with the
installments
type in the payment_method_data
object, and the redirect
type as well as the URL of a page on your side for redirecting the user after the payment (in the return_url
parameter) in the confirmation
object.Example of request
curl https://api.yookassa.ru/v3/payments \ -X POST \ -u <Shop ID>:<Secret Key> \ -H 'Idempotence-Key: <Idempotence Key>' \ -H 'Content-Type: application/json' \ -d '{ "amount": { "value": "2.00", "currency": "RUB" }, "payment_method_data": { "type": "installments" }, "confirmation": { "type": "redirect", "return_url": "https://www.example.com/return_url" }, "description": "Order No. 72" }'
Step 2. Redirect the user to the payment page (you will receive the URL in the
confirmation_url
parameter).Example of a created payment object
{ "id": "22c5d4d1-000f-5000-a000-1060585f5f12", "status": "pending", "paid": false, "amount": { "value": "2.00", "currency": "RUB" }, "confirmation": { "type": "redirect", "confirmation_url": "https://yoomoney.ru/credit/order/step/options?orderId=22c5d4d1-000f-5000-a000-1060585f5f12" }, "created_at": "2018-06-27T16:53:37.322Z", "description": "Order No. 72", "metadata": {}, "payment_method": { "type": "installments", "id": "22c5d4d1-000f-5000-a000-1060585f5f12", "saved": false }, "recipient": { "account_id": "100500", "gateway_id": "100700" }, "refundable": false, "test": false }
Step 3. Wait for the payment to be successfully completed: you will receive a notification from YooMoney, or you can send periodic requests for payment information .
If 30 days or more have passed since the date of sale on credit, notify the manager before making a refund: they will help you do it properly.
See also