Система Быстрых Платежей (SBP)
Процесс проведения оплаты
Процесс проведения платежа этим методом содержит следующие этапы:
- Вы инициируете запрос на оплату.
- Система направляет запрос провайдеру платежного метода. СБП генерирует QR-код для проведения оплаты.
- Вы получаете ответ и перенаправляете клиента на полученный URL.
- Клиент получает QR-код и проводит оплату.
- Вам приходит автоматическое уведомление о статусе платежа, если в запросе на проведение оплаты был передан параметр
notification_url.
Для данного альтернативного способа оплаты поддерживаются следующие операции:
Оплата
Запрос
Отправьте запрос оплаты со следующими дополнительными данными:
|
|||||||
Ответ
Ответ на запрос оплаты будет дополнительно содержать секцию form со ссылкой для перехода к странице с QR-кодом. Направьте клиента на URL, переданный как значение параметра form.action.
Запрос статуса операции
Запрос
Если необходимо дополнительно узнать статус платежа, отправьте запрос получения статуса платежа.
Ответ
Ответ будет содержать статус транзакции, секцию параметров способа оплаты, а также иную информацию о транзакции согласно описанию запроса получения статуса платежа.
Возврат средств клиенту
Запрос
Если необходимо вернуть платеж клиенту, отправьте запрос возврата средств c UID транзакции оплаты.
Ответ
Ответ будет содержать статус транзакции, а также иную информацию о транзакции согласно описанию запроса возврата средств.
Вариант интеграции TC
Info
Данная интеграция поддерживает только валюту RUB.
Оплата
Процесс проведения оплаты
- Покупатель инициирует платеж.
- Торговец отправляет запрос оплаты в 2can.
- 2can присылает в ответе URL для перенаправления покупателя.
- Торговец перенаправляет покупателя на полученный URL.
- По ссылке отображается QR-код. Покупатель сканирует QR-код и завершает оплату.
- Торговец получает автоматическое уведомление о результате транзакции.
- Торговец уведомляет покупателя о результате оплаты.
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
|
|||||||||||||||||
Пример запроса
{
"request": {
"amount": 100,
"currency": "RUB",
"description": "description",
"test": true,
"ip": "127.0.0.1",
"tracking_id": "11111111",
"language": "ru",
"notification_url": "https://merchant.ltd/notification",
"return_url": "https://merchant.ltd/return",
"method": {
"type": "sbp"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "0673a56e-9ced-4746-a9cc-64472b96b209",
"type": "payment",
"status": "pending",
"amount": 200,
"currency": "RUB",
"description": "description",
"created_at": "2025-09-26T09:13:31Z",
"updated_at": "2025-09-26T09:13:33Z",
"method_type": "sbp",
"receipt_url": "https://ecom-backoffice.2can.ru/customer/transactions/0673a56e-9ced-4746-a9cc-64472b96b209/d7cf1af87f2e432c11d8399a5a554adbd30676cfcbaa0790a0d8a76727be97b8?language=ru",
"payment": {
"status": "pending",
"gateway_id": 5756,
"ref_id": "AD1432A2BFB445D1992B7F07FA7C9177",
"message": "Transaction was initialized.",
"bank_code": 0
},
"sbp": {
"type": "sbp"
},
"customer": {
"email": null,
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized.",
"tracking_id": "11111111",
"test": true,
"language": "ru",
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": true
},
"form": {
"action": "payment-link",
"fields": [],
"method": "GET"
}
}
}
Возврат средств
Запрос
Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции.
Вариант интеграции MBP2
Процесс проведения выплаты
- Покупатель инициирует выплату на сайте торговца.
- Торговец отправляет в 2can запрос списка поддерживаемых банков.
- 2can присылает в ответе список доступных банков, а также
bank_nameиbank_codeдля каждого из доступных банков. - Торговец отправляет в 2can запрос на выплату, указав в запросе
bank_code. - 2can высылает торговцу ответ с промежуточным статусом.
- Торговец получает автоматическое уведомление о результате транзакции.
- Торговец уведомляет покупателя о результате выплаты.
Info
Данная интеграция поддерживает только валюту RUB.
Список поддерживаемых банков
Запрос
POST https://api-ecom-gateway.2can.ru/beyag/gateways/{gateway_id}/bank_list
Значение {gateway_id} в пути запроса – это идентификатор шлюза, активированного для вашего магазина для этой интеграции. Чтобы получить значение gateway_id, обратитесь в службу технической поддержки или к вашему менеджеру.
Ответ
|
|||||||||||||
Пример ответа
{
"response": {
"list": [
{
"bank_code": "188888888885",
"bank_name": "Золотой Банк"
},
{
"bank_code": "100000000017",
"bank_name": "МТС Банк"
}
]
}
}
Выплата
Запрос
Отправьте запрос выплаты со следующими дополнительными параметрами:
|
|||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 100,
"currency": "RUB",
"description": "description",
"test": false,
"skip_duplicate_check": true,
"tracking_id": "123",
"language": "en",
"return_url": "https://example.com/",
"customer": {
"first_name": "John",
"middle_name": "Michael",
"last_name": "Doe"
},
"method": {
"type": "sbp",
"bank_code": "1crt88888881",
"account_number": "79126543434"
}
}
}
Ответ
Пример ответа
{
"transaction": {
"uid": "b4a599d8-44d6-41e9-8bac-6a1f6fb859d0",
"type": "payout",
"status": "pending",
"amount": 100,
"currency": "RUB",
"description": "description",
"created_at": "2026-09-03T15:10:23Z",
"updated_at": "2026-09-03T15:10:23Z",
"manually_corrected_at": null,
"method_type": "sbp",
"receipt_url": "https://ecom-backoffice.2can.ru/customer/transactions/b4a599d8-44d6-41e9-8bac-6a1f6fb859d0/0bc1462277dafcebdb6d9b90287eeba19589d1149997ee9cba17b2dc07dff987?language=en",
"payout": {
"status": "pending",
"gateway_id": 7224,
"ref_id": "806258176533406",
"message": "В обработке. Требуется подтвердить проведение платежа",
"bank_code": "0"
},
"sbp": {
"type": "sbp",
"bank_code": "1crt88888881",
"account_number": "79126543434"
},
"customer": {
"email": null,
"ip": null
},
"version": 3,
"message": "В обработке. Требуется подтвердить проведение платежа",
"tracking_id": "123",
"test": false,
"language": "en",
"billing_address": {
"last_name": "Doe",
"first_name": "John",
"middle_name": "Michael"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "skipped"
}
}
}