YooMoney API
Guides
Old versions of the API
Help
Sign up for YooMoney
Installments
 
Specifics
  • 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
Integration scenarios
Ready-made solutions: Smart payment
You can also embed a widget to display the monthly payment amounts.
Payment via the Installments service
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
PHP
Python
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
JSON
{
  "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 .
Specifics of refunds
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