СберБанк Бизнес Онлайн — Прием платежей в интернет-магазине по API ЮKassa

СберБанк Бизнес Онлайн

Особенности

Тип способа оплаты в API:
b2b_sberbank
Сценарий подтверждения: Redirect
Срок оплаты: 8 часов
Холдирование: нельзя платить в две стадии
Код в реестре: 2S
Возврат: нет
Автоплатежи: нет
Лимиты: минимальный размер платежа — 1 рубль, максимальный — 5 млн рублей, есть дополнительные ограничения

Сценарии интеграции

Доступно только для самостоятельной интеграции.

Оплата в сервисе СберБанк Бизнес Онлайн

Подключение способа оплаты

Сообщите менеджеру ЮKassa о своем желании подключить этот способ оплаты.
Пополните обеспечительный счет, с которого ЮKassa будет списывать комиссию за проведение платежей (реквизиты придут вам на электронную почту).

Проведение платежа

Шаг 1. Создайте платеж :

в объекте
payment_method_data
передайте тип
b2b_sberbank
, опишите назначение платежа и укажите информацию об НДС;
в объекте
confirmation
передайте тип
redirect
и адрес страницы на вашей стороне, на которую пользователь вернется после оплаты (в параметре
return_url
);
в параметре
capture
передайте значение
true
, чтобы платеж автоматически перешел в статус
succeeded
после оплаты.

Пример запроса

cURL
PHP
Python
curl https://api.yookassa.ru/v3/payments \
  -X POST \
  -u <Идентификатор магазина>:<Секретный ключ> \
  -H 'Idempotence-Key: <Ключ идемпотентности>' \
  -H 'Content-Type: application/json' \
  -d '{
        "amount": {
          "value": "50.00",
          "currency": "RUB"
        },
        "payment_method_data": {
          "type": "b2b_sberbank",
          "payment_purpose": "Оплата заказа №2134",
          "vat_data": {
            "type": "calculated",
            "rate": 18,
            "amount": {
              "value": 9.00,
              "currency": "RUB"
            }
          }
        },
        "confirmation": {
          "type": "redirect",
          "return_url": "https://www.merchant-website.com/return_url"
        },
        "capture": true,
        "description": "Оплата заказа №2134"
      }'

Шаг 2. Перенаправьте пользователя на страницу для подтверждения оплаты (ссылка на страницу придет в параметре

confirmation_url

Пример созданного объекта платежа

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": "Оплата заказа №2134",
  "metadata": {},
  "payment_method": {
    "id": "1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
    "type": "b2b_sberbank",
    "saved": false,
    "payment_purpose": "Оплата заказа №2134",
    "vat_data": {
      "type": "calculated",
      "amount": {
        "value": "9.00",
        "currency": "RUB"
      },
      "rate": "18"
    }
  },
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  },
  "refundable": false,
  "test": false
}

Шаг 3. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже .

Пример объекта платежа в статусе succeeded

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": "Оплата заказа №2134",
  "metadata": {},
  "payment_method": {
    "id": "1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
    "type": "b2b_sberbank",
    "saved": false,
    "payer_bank_details": {
      "account": "40702810355002135468",
      "address": "197111, Российская Федерация, г.Санкт-Петербург, ул.3-й Северовокзальный, д.17, корп./стр.2, кв.16",
      "bank_bik": "044030653",
      "bank_branch": "СЕВЕРО-ЗАПАДНЫЙ БАНК СБЕРБАНКА РФ",
      "bank_name": "СЕВЕРО-ЗАПАДНЫЙ БАНК ПАО СБЕРБАНК",
      "full_name": "Общество с ограниченной ответственностью 'Организация'",
      "inn": "7728662610",
      "kpp": "783501610",
      "short_name": "ООО 'Организация'"
    },
    "payment_purpose": "Оплата заказа №2134",
    "vat_data": {
      "type": "calculated",
      "amount": {
        "value": "9.00",
        "currency": "RUB"
      },
      "rate": "18"
    }
  },
  "refunded_amount": {
    "value": "0.00",
    "currency": "RUB"
  },
  "refundable": false,
  "test": false
}

Есть вопросы или замечания по документации?

Можем созвониться и обсудить их лично: мы поможем вам разобраться, а вы нам — понять, что тут нужно улучшить. Для этого оставьте свои контакты и выберите время.

Да, хочу обсудить

Что почитать еще

Основы проведения платежей Неуспешные платежи Оплата по 54-ФЗ

Особенности

Оплата в сервисе СберБанк Бизнес Онлайн