SberBank Business Online — Payment acceptance via the YooMoney API

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

For manual integration only.

Payment in SberBank Business Online

Implementation

Inform the YooMoney manager that you’d like to implement this payment method.
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
}