YooMoney API
Guides
Old versions of the API
Help
Sign up for YooMoney
SberBank Business Online
 
Specifics
  • Payment method type in the API: b2b_sberbank
  • Confirmation scenario: Redirect
  • Payment term: 8 hours
  • Holding: two-stage payments are unavailable
  • Code in reports: 2S
  • Refund: no
  • Recurring payments: no
  • Limits: the minimum payment amount is 1 ruble, and the maximum amount is 700,000 rubles (you can raise the limit by contacting the manager), there are additional restrictions
Integration scenarios
Payment in SberBank Business Online
Implementation
  1. Inform the YooMoney manager that you’d like to implement this payment method.
  2. Add money to the payout account that YooMoney will use for charging the payment processing commission (you will receive the banking details by email).
Processing payment
Step 1. Create a payment :
  • in the payment_method_data object, set the b2b_sberbank type, specify the payment purpose, and provide the information about VAT;
  • in the confirmation object, set the redirect type and specify the URL of the page on your side that the user will be redirected to after completing the payment (in the return_url parameter);
  • in the capture parameter, set the true value so the payment status will automatically change to succeeded after the payment.
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": "50.00",
          "currency": "RUB"
        },
        "payment_method_data": {
          "type": "b2b_sberbank",
          "payment_purpose": "Payment for order No. 37",
          "vat_data": {
            "type": "calculated",
            "rate": 18,
            "amount": {
              "value": 9.00,
              "currency": "RUB"
            }
          }
        },
        "confirmation": {
          "type": "redirect",
          "return_url": "https://www.example.com/return_url"
        },
        "capture": true,
        "description": "Payment for order No. 37"
      }'
Step 2. Redirect the user to the payment confirmation page (you will receive the URL in the confirmation_url parameter).
Example of a created payment object
JSON
{
  "id": "1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
  "status": "pending",
  "paid": false,
  "amount": {
    "value": "50.00",
    "currency": "RUB"
  },
  "confirmation": {
    "type": "redirect",
    "confirmation_url": "http://b2bsberbank.confirmation.url?orderId=1da5c87d-0984-50e8-a7f3-8de646dd9ec9"
  },
  "created_at": "2017-06-29T22:20:00.000Z",
  "description": "Payment for order No. 37",
  "metadata": {},
  "payment_method": {
    "id": "1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
    "type": "b2b_sberbank",
    "saved": false,
    "payment_purpose": "Payment for order No. 37",
    "vat_data": {
      "type": "calculated",
      "amount": {
        "value": "9.00",
        "currency": "RUB"
      },
      "rate": "18"
    }
  },
  "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 .
Example of a created payment object
JSON
{
  "id": "1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
  "status": "succeeded",
  "paid": true,
  "amount": {
    "value": "50.00",
    "currency": "RUB"
  },
  "captured_at": "2017-06-29T22:30:00.000Z",
  "created_at": "2017-06-29T22:20:00.000Z",
  "description": "Payment for order No. 37",
  "metadata": {},
  "payment_method": {
    "id": "1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
    "type": "b2b_sberbank",
    "saved": false,
    "payer_bank_details": {
      "account": "40702810355002135468",
      "address": "17 Severovokzalny ul., bld. 2, apt. 16, Saint Petersburg 197111, Russian Federation",
      "bank_bik": "044030653",
      "bank_branch": "SEVERO-ZAPADNY BANK OF SBERBANK OF RF",
      "bank_name": "SEVERO-ZAPADNY BANK PAO SBERBANK",
      "full_name": "Limited liability company 'Organization'",
      "inn": "7728662610",
      "kpp": "783501610",
      "short_name": "'Organization' LLC"
    },
    "payment_purpose": "Payment for order No. 37",
    "vat_data": {
      "type": "calculated",
      "amount": {
        "value": "9.00",
        "currency": "RUB"
      },
      "rate": "18"
    }
  },
  "refunded_amount": {
    "value": "0.00",
    "currency": "RUB"
  },
  "refundable": false,
  "test": false
}
See also