Система Быстрых Платежей (SBP)
Процесс проведения оплаты
Процесс проведения платежа этим методом содержит следующие этапы:
- Вы инициируете запрос на оплату.
- Система направляет запрос провайдеру платежного метода. СБП генерирует QR-код для проведения оплаты.
- Вы получаете ответ и перенаправляете клиента на полученный URL.
- Клиент получает QR-код и проводит оплату.
- Вам приходит автоматическое уведомление о статусе платежа, если в запросе на проведение оплаты был передан параметр
notification_url.
Для данного альтернативного способа оплаты поддерживаются следующие операции:
Оплата
Запрос
Отправьте запрос оплаты со следующими дополнительными данными:
|
|||||||
Ответ
Ответ на запрос оплаты будет дополнительно содержать секцию form со ссылкой для перехода к странице с QR-кодом. Направьте клиента на URL, переданный как значение параметра form.action.
Запрос статуса операции
Запрос
Если необходимо дополнительно узнать статус платежа, отправьте запрос получения статуса платежа.
Ответ
Ответ будет содержать статус транзакции, секцию параметров способа оплаты, а также иную информацию о транзакции согласно описанию запроса получения статуса платежа.
Возврат средств клиенту
Запрос
Если необходимо вернуть платеж клиенту, отправьте запрос возврата средств c UID транзакции оплаты.
Ответ
Ответ будет содержать статус транзакции, а также иную информацию о транзакции согласно описанию запроса возврата средств.
Вариант интеграции PTP
Info
Данная интеграция поддерживает только валюту RUB.
Оплата
Процесс проведения оплаты
- Покупатель инициирует платеж на сайте торговца.
- Торговец отправляет запрос оплаты в Overpay.
- Overpay присылает в ответе URL на страницу СБП с QR-кодом для оплаты.
- Торговец перенаправляет покупателя на полученный URL.
- Покупатель сканирует QR-код, выбирает банк из списка доступных, перенаправляется в приложение выбранного банка и подтверждает оплату. Также покупатель может отсканировать код из банковского приложения.
- Торговец получает автоматическое уведомление о результате транзакции.
- Торговец уведомляет покупателя о результате оплаты.
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
|
|||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 100000,
"currency": "RUB",
"description": "description",
"return_url": "https://merchant.ltd/return",
"customer": {
"first_name": "John",
"last_name": "Doe",
"phone": "+111111111111",
"email": "example@example.com"
},
"method": {
"type": "sbp"
}
}
}
Ответ
Ответ на запрос оплаты будет дополнительно содержать секцию form со ссылкой для перехода к странице с QR-кодом. Направьте покупателя на URL, переданный как значение параметра form.action.
Пример ответа
{
"transaction": {
"uid": "debf8377-3546-462e-b372-5c3a18838de5",
"type": "payment",
"status": "pending",
"amount": 100000,
"currency": "RUB",
"description": "description",
"created_at": "2024-04-03T19:55:38Z",
"updated_at": "2024-04-03T19:55:39Z",
"method_type": "sbp",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/debf8377-3546-462e-b372-5c3a18838de5/8190f452c202e3d6e8ae1bf654bad55fae5a74143f7fed92f2be7879664ccb47",
"payment": {
"status": "pending",
"gateway_id": 3878,
"ref_id": "601318084",
"message": "Transaction was initialized."
},
"sbp": {
"type": "sbp"
},
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "example@example.com",
"phone": "+111111111111",
"ip": null
},
"manually_corrected_at": null,
"message": "Transaction was initialized.",
"test": false,
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"email": "example@example.com",
"phone": "+111111111111"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": true
},
"form": {
"action": "https://qr.nspk.ru/AD100001EB6TL7KF8CCAD8DD0HLMCS5V?type=02&bank=100000000143&sum=100000&cur=RUB&crc=1479",
"method": "GET",
"fields": []
}
}
}
Возврат средств
Запрос
Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.
Выплата
Процесс проведения выплаты
- Торговец отправляет в Overpay запрос на выплату, указав в запросе
bank_code. Запросите список доступных банков и соответствующихbank_codeу службы технической поддержки или у вашего менеджера. - Overpay высылает торговцу ответ с промежуточным статусом.
- Торговец получает автоматическое уведомление о результате транзакции.
Запрос
Отправьте запрос выплаты со следующими дополнительными параметрами:
|
|||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 20000,
"currency": "RUB",
"description": "description",
"test": true,
"method": {
"type": "sbp",
"account_number": "+123456789123",
"bank_code": "100000000202"
}
}
}
Ответ
Пример ответа
{
"transaction": {
"uid": "2757482e-4490-4c8c-a223-f554a21dc370",
"type": "payout",
"status": "pending",
"amount": 20000,
"currency": "RUB",
"description": "description",
"created_at": "2024-04-04T13:40:40Z",
"updated_at": "2024-04-04T13:40:40Z",
"manually_corrected_at": null,
"method_type": "sbp",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/2757482e-4490-4c8c-a223-f554a21dc370/1aa3bd868381ee7766b02261b03abd12526e30f85a194938719e5ab4c28e2b28",
"payout": {
"status": "pending",
"gateway_id": 3878,
"message": "Transaction was initialized.",
"bank_code": 100
},
"sbp": {
"type": "sbp"
},
"customer": {
"email": null,
"ip": null
},
"message": "Transaction was initialized.",
"test": true,
"billing_address": {},
"additional_data": {
"payment_method": {
"type": "alternative"
}
}
}
}
Вариант интеграции CP
Info
Данная интеграция поддерживает только валюту RUB.
Оплата
Процесс проведения оплаты
- Покупатель инициирует платеж на сайте торговца.
- Торговец отправляет запрос оплаты в Overpay.
- Overpay присылает в ответе URL на страницу СБП с QR-кодом для оплаты.
- Торговец перенаправляет покупателя на полученный URL. Время жизни ссылки – 30 минут.
- Покупатель сканирует QR-код, выбирает банк из списка доступных, перенаправляется в приложение выбранного банка и подтверждает оплату. Также покупатель может отсканировать код из банковского приложения.
- Торговец получает автоматическое уведомление о результате транзакции.
- Торговец уведомляет покупателя о результате оплаты.
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
|
|||||||||||||||
Пример запроса
{
"request": {
"amount": 8111,
"currency": "RUB",
"description": "description",
"ip": "127.0.0.1",
"test": false,
"tracking_id": "your_uniq_number",
"return_url": "https://return-url",
"method": {
"type": "sbp"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "8209bb9d-3f99-43bc-a502-37f3899eab42",
"type": "payment",
"status": "pending",
"amount": 8111,
"currency": "RUB",
"description": "description",
"created_at": "2024-06-25T14:31:25Z",
"updated_at": "2024-06-25T14:31:25Z",
"method_type": "sbp",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/8209bb9d-3f99-43bc-a502-37f3899eab42/7677cb7cad037d0fdf61791104106b1034f07a39e769145d912484ebeb4bdbb9?language=en",
"payment": {
"status": "pending",
"gateway_id": 4152,
"ref_id": "2019561",
"message": "Transaction was initialized."
},
"sbp": {
"type": "sbp"
},
"customer": {
"email": null,
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number",
"test": false,
"language": "en",
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": true
},
"form": {
"action": "https://qr.nspk.ru/AS100001ORTF4GAF80KPJ53K186D9A3G?type=01&bank=100000000007&crc=0C8A",
"method": "GET",
"fields": []
}
}
}
Вариант интеграции IZ
Info
Данная интеграция поддерживает только валюту RUB.
Оплата
Процесс проведения оплаты
- Покупатель инициирует платеж на сайте торговца.
- Торговец отправляет запрос оплаты в Overpay.
- Overpay присылает в ответе параметры для создания HTML-формы для оплаты. Время жизни ссылки
form.action– 15 минут. - Торговец создает HTML-форму для оплаты, используя значения параметров из ответа.
- Торговец перенаправляет покупателя на форму для оплаты.
- Покупатель подтверждает оплату.
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
|
|||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 10000,
"currency": "RUB",
"description": "description",
"test": false,
"tracking_id": "your_uniq_number",
"return_url": "https://return-url",
"customer": {
"phone": "1234567890",
"email": "example@example.com"
},
"method": {
"type": "sbp"
}
}
}
Ответ
Создайте HTML-форму, используя параметры из секции form. Отправьте покупателя на форму для завершения оплаты.
Пример ответа
{
"transaction": {
"uid": "19088621-95e0-4100-b0a8-1717c69a9600",
"type": "payment",
"status": "pending",
"amount": 10000,
"currency": "RUB",
"description": "description",
"created_at": "2024-07-03T12:21:16Z",
"updated_at": "2024-07-03T12:21:16Z",
"method_type": "sbp",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/19088621-95e0-4100-b0a8-1717c69a9600/863e4e14692a6698664f758c39177d6b2c03f8f3de6e233e1020d098a7b0428f",
"payment": {
"status": "pending",
"gateway_id": 4163,
"message": "Transaction was initialized."
},
"sbp": {
"type": "sbp"
},
"customer": {
"email": "example@example.com",
"phone": "1234567890",
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number",
"test": false,
"billing_address": {
"email": "example@example.com",
"phone": "1234567890"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": true
},
"form": {
"action": "https://payment-page",
"method": "POST",
"fields": [
{
"name": "amount",
"value": "100.00",
"type": "hidden"
},
{
"name": "amountcurr",
"value": "RUB",
"type": "hidden"
},
{
"name": "currency",
"value": "EXT",
"type": "hidden"
},
{
"name": "number",
"value": "a241a368c8hu9639786382d7592e34",
"type": "hidden"
},
{
"name": "description",
"value": "www.site.com",
"type": "hidden"
},
{
"name": "trtype",
"value": "1",
"type": "hidden"
},
{
"name": "phone",
"value": "0987654321",
"type": "hidden"
},
{
"name": "email",
"value": "1@example.com",
"type": "hidden"
},
{
"name": "account",
"value": "ACC041111",
"type": "hidden"
},
{
"name": "signature",
"value": "6A886FJ609RITN5960HIYK403D5170CA3EBB55",
"type": "hidden"
}
]
}
}
}
Вариант интеграции MT
Info
Данная интеграция поддерживает только валюту RUB.
Оплата
Процесс проведения оплаты
- Покупатель инициирует платеж на сайте торговца.
- Торговец отправляет запрос оплаты в Overpay.
- Overpay присылает в ответе URL на страницу СБП с QR-кодом для оплаты.
- Торговец перенаправляет покупателя на полученный URL. Время жизни ссылки по умолчанию – 15 минут.
- Покупатель сканирует QR-код, выбирает банк из списка доступных, перенаправляется в приложение выбранного банка и подтверждает оплату. Также покупатель может отсканировать код из банковского приложения. При открытии ссылки на мобильном устройстве, покупателю сразу отображается список банковских приложений для завершения оплаты.
- Торговец получает автоматическое уведомление о результате транзакции.
- Торговец уведомляет покупателя о результате оплаты.
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
|
|||||||||||||
Пример запроса
{
"request": {
"amount": 100000,
"currency": "RUB",
"description": "description",
"return_url": "https://merchant.ltd/return",
"method": {
"type": "sbp"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "ff907a25-c194-44bb-b3ec-9a943f89f863",
"type": "payment",
"status": "pending",
"amount": 100000,
"currency": "RUB",
"description": "description",
"created_at": "2024-09-23T13:21:05Z",
"updated_at": "2024-09-23T13:21:06Z",
"method_type": "sbp",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/ff907a25-c194-44bb-b3ec-9a943f89f863/fc6fcec74ae131c4afad01db10a2abd209b91b0b4e54c8af65a38485bbcdd245",
"payment": {
"status": "pending",
"gateway_id": 4497,
"ref_id": "3960848",
"message": "Transaction was initialized."
},
"sbp": {
"type": "sbp"
},
"customer": {
"email": null,
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"test": false,
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "https://qr.nspk.ru/AD100066PTMO2TOG8S1B64I8GGMR32GR",
"method": "GET",
"fields": []
}
}
}
Возврат средств
Запрос
Для возврата средств по платежу, отправьте запрос на возврат средств. Возврат можно осуществить однократно на полную или частичную сумму родительской транзакции.
Вариант интеграции AR
Оплата
Процесс проведения оплаты
- Покупатель инициирует платеж на сайте торговца.
- Торговец отправляет запрос оплаты в Overpay.
- Overpay присылает в ответе URL для перенаправления покупателя.
- Торговец перенаправляет покупателя на полученный URL. Если ссылка открыта на десктопе: показывается QR-код, который покупатель может отсканировать камерой мобильного устройства или через банковское приложение. Если ссылка открыта на мобильном устройстве: покупателю сразу отображается список доступных банковских приложений для завершения оплаты. Если у покупателя нет подходящих приложений, то открывается браузер на странице НСПК, откуда покупатель может перейти в web-версию мобильного банка, если выбранный банк предоставляет такую возможность.
- Покупатель завершает платеж в приложении банка или в web-версии мобильного банка.
- Торговец получает автоматическое уведомление о результате транзакции.
- Торговец уведомляет покупателя о результате оплаты.
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
|
|||||||||||||
Пример запроса
{
"request": {
"amount": 100000,
"currency": "RUB",
"description": "description",
"return_url": "https://merchant.ltd/return",
"method": {
"type": "sbp_deeplink"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "6436319e-9471-4a37-955e-caf38404e166",
"type": "payment",
"status": "pending",
"amount": 100000,
"currency": "RUB",
"description": "description",
"created_at": "2024-12-26T11:04:02Z",
"updated_at": "2024-12-26T11:04:02Z",
"method_type": "sbp_deeplink",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/6436319e-9471-4a37-955e-caf38404e166/6bc187992f2697d112677ef0cadf772b8d28a6ab49ad6644b7b0245fd8a8f763",
"payment": {
"status": "pending",
"gateway_id": 4772,
"ref_id": "2bad37ec-874f-416b-bee1-c490edd8cc16",
"message": "Transaction was initialized."
},
"sbp_deeplink": {
"type": "sbp_deeplink"
},
"customer": {
"email": null,
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"test": false,
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "skipped",
"data": null
},
"gateway": {
"iframe": true
},
"form": {
"action": "https://qr.nspk.ru/AD100073NTMRD90L96CQO6UCDJA4DR7O",
"method": "GET",
"fields": []
}
}
}
Возврат средств
Запрос
Для возврата средств по платежу, отправьте запрос на возврат средств. Возврат можно осуществить на полную или частичную сумму родительской транзакции. Повторный запрос на возврат на частичную сумму родительской транзакции можно осуществить только после финализации первого запроса на частичный возврат.
Выплата
Процесс проведения выплаты
- Торговец отправляет в Overpay запрос на выплату, указав в запросе
bank_code. - Overpay высылает торговцу ответ с промежуточным статусом.
- Торговец получает автоматическое уведомление о результате транзакции.
Запрос
Отправьте запрос выплаты со следующими дополнительными параметрами:
|
|||||||||||||||
Пример запроса
{
"request": {
"amount": 20000,
"currency": "RUB",
"description": "description",
"test": true,
"method": {
"type": "sbp_deeplink",
"account_number": "123456789123",
"bank_code": "100000000202"
}
}
}
Ответ
Пример ответа
{
"transaction": {
"uid": "628994ee-1416-44c2-83b8-911209f3d70f",
"type": "payout",
"status": "pending",
"amount": 108,
"currency": "RUB",
"description": "108",
"created_at": "2024-12-26T11:48:45Z",
"updated_at": "2024-12-26T11:48:47Z",
"manually_corrected_at": null,
"method_type": "sbp_deeplink",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/628994ee-1416-44c2-83b8-911209f3d70f/9de6fac6b341bf438e22bbbf547487587f62188a04f8dd0b018eed9adc6a5506?language=en",
"payout": {
"status": "pending",
"gateway_id": 4764,
"ref_id": "31a10280-2145-4ce7-a186-1e61ecb85603",
"message": "",
"bank_code": ""
},
"sbp_deeplink": {
"type": "sbp_deeplink",
"bank_code": "100000000202",
"account_number": "123456789123"
},
"customer": {
"email": null,
"ip": "127.0.0.1"
},
"version": 0,
"message": "",
"tracking_id": "your_uniq_number",
"test": false,
"language": "en",
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "skipped",
"data": null
}
}
}
Вариант интеграции BD
Info
Этот вариант интеграции поддерживает только валюту RUB.
Оплата
Процесс проведения оплаты
- Покупатель инициирует платеж.
- Торговец отправляет запрос оплаты в Overpay.
- Overpay присылает в ответе URL для перенаправления покупателя.
- Торговец перенаправляет покупателя на полученный URL.
- По ссылке отображается QR-код. Покупатель сканирует QR-код и завершает оплату.
- Торговец получает автоматическое уведомление о результате транзакции.
- Торговец уведомляет покупателя о результате оплаты.
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
|
|||||||||||||
Пример запроса
{
"request": {
"amount": 202,
"currency": "RUB",
"description": "description",
"test": true,
"return_url": "https://merchant.ltd/return",
"method": {
"type": "sbp"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "10125b6d-497a-4aae-900a-80305d8c2f93",
"type": "payment",
"status": "pending",
"amount": 202,
"currency": "RUB",
"description": "description",
"created_at": "2025-10-10T09:12:35Z",
"updated_at": "2025-10-10T09:12:37Z",
"method_type": "sbp",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/10125b6d-497a-4aae-900a-80305d8c2f93/8886d50c0e6873b9ee1083919a104c8d94e5736992c8b8ed4a0958b7f290347a",
"payment": {
"status": "pending",
"gateway_id": 5807,
"ref_id": "5WDY2OB6ZQAAVE5PMHX9C7DFHQ9IS00I",
"message": "Transaction was initialized."
},
"sbp": {
"type": "sbp"
},
"customer": {
"email": null,
"ip": null
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized.",
"test": true,
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "payment-link",
"fields": [],
"method": "GET"
}
}
}
Выплата
Процесс проведения выплаты
- Торговец отправляет в Overpay запрос на выплату, указав в запросе
bank_code. - Overpay высылает торговцу ответ с промежуточным статусом.
- Торговец получает автоматическое уведомление о результате транзакции.
Запрос
Отправьте запрос выплаты со следующими дополнительными параметрами:
|
|||||||||||||||
Пример запроса
{
"request": {
"amount": 100,
"currency": "RUB",
"description": "description",
"test": false,
"tracking_id": "your_uniq_number",
"ip": "127.0.0.1",
"language": "en",
"notification_url": "https://your-notification.url",
"return_url": "https://your-success.url",
"method": {
"type": "sbp",
"bank_code": "1188888888886",
"account_number": "0079123456789"
}
}
}
Ответ
Пример ответа
{
"transaction": {
"uid": "5e2040f5-38d8-4c9b-81ea-d267c0534d04",
"type": "payout",
"status": "pending",
"amount": 100,
"currency": "RUB",
"description": "description",
"created_at": "2025-10-08T13:19:41Z",
"updated_at": "2025-10-08T13:19:42Z",
"manually_corrected_at": null,
"method_type": "sbp",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/5e2040f5-38d8-4c9b-81ea-d267c0534d04/c81732a8b6b1f15f9a178cb28d5ebfb56606b2932450116a3725aa851bab670c?language=en",
"payout": {
"status": "pending",
"gateway_id": 5807,
"ref_id": "5e2040f5-38d8-4c9b-81ea-d267c0534d04",
"message": "Transaction was initialized."
},
"sbp": {
"type": "sbp"
},
"customer": {
"email": null,
"ip": null
},
"version": 1,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number",
"test": false,
"language": "en",
"additional_data": {
"payment_method": {
"type": "alternative"
}
}
}
}
Список поддерживаемых банков
Запрос
POST https://api.overpay.io/beyag/gateways/{gateway_id}/bank_list
Значение {gateway_id} в пути запроса - это идентификатор шлюза, активированного для вашего магазина для этой интеграции. Чтобы получить значение gateway_id, обратитесь в службу технической поддержки или к вашему менеджеру.
Пример запроса
curl --location --request GET 'https://api.overpay.io/beyag/gateways/{gateway_id}/bank_list'
--header 'Content-Type: application/json'
--header 'Accept: application/json'
--header 'Authorization: Basic {authorization token}'
Ответ
|
|||||||||||||
Пример ответа
{
"response": {
"list": [
{
"bank_code": "188888888885",
"bank_name": "Золотой Банк"
},
{
"bank_code": "188888888886",
"bank_name": "УМ Банк"
}
]
}
}