В платежный шлюз будет передана информация по платежу и будет создан счет, для которого будет сгенерирована ссылка на оплату. Результатом вызова будет являться идентификатор счета и ссылка на оплату. При вызове метода, необходимо использовать SSL сертификат.
Заголовок запроса
POST |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| Request-Id | guid | да | Идентификатор конкретного запроса |
Requestor-Name | string | нет | Наименование сервиса.
|
| Requestor-Type | string | нет | Тип витрины.
|
| Requestor-Version | string | нет | Версия виджета/sdk |
Тело запроса
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
account | string | нет | Номер банковского счета юр.лица для зачисления платежа. Если у юридического лица только один счет, то параметр может не передаваться. Для получения QR кода счет должен быть зарегистрирован в СБП |
accAlias | string[127] | нет | Алиас банковского счета юр.лица для зачисления платежа. Если у юридического лица более 1 счета, то в запросе должен быть указан либо Account, либо AccAlias |
amount | amount | да | Сумма платежа в рублях (валюта только RUB). Сумма обязательна для qrcType = 02 |
serviceId | int64 | нет | ID сервиса |
serviceParams | object | нет | Набор пар "параметр":"значение", описывающих реквизиты платежа (специфичных для каждого поставщика) |
description | string[140] | нет | Назначение платежа (UTF-8). Длина не более 140. В случае сценария пополнения, поле должно содержать номер пополняемого телефона в формате (9999999999) |
| redirectUrl | string | нет | Ссылка для редиректа пользователя после оплаты |
| lifeTime | int32 | нет | Время жизни ссылки (в минутах). Если значение не передано, то по умолчанию устанавливается - 72 часа. Если указано меньше 5 минут, то сервисом МТС Банка устанавливается значение - 5 минут. |
Content-Type: application/json; charset=utf-8 |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
id | int64 | да | Идентификатор счета |
paymentId | int64 | да | Идентификатор платежа по QR |
status | string | да | Статус счета:
|
invoicePaymentPageUrl | string | нет | Ссылка на форму оплаты счета (платежную страницу). Форма оптимизирована для оплаты счета и должна использоваться в случае использования сервиса как платежной системы. Перейдя по данной ссылке покупатель имеет возможность оплатить счет через свой банк или скачать счет в PDF |
POST https://sandbox.pay.mts.ru/private/v1/invoicing/sbp/create HTTP/1.1 |
{
"account" : "40702810520030000157",
"accAlias" : "28db3bf4-2090-4d70-84ff-7319378a90cb",
"amount" : 1300.01,
"serviceId": "5560",
"serviceParams": {
"NUMBER": "79160026188",
"payerEmail": "tests12345@mts.ru",
"id1": "108882256562"
},
"description" : "Покупка чего-то там",
"lifeTime": 14,
"redirectUrl": "pay.mts.ru/success"
}
Content-Type: application/json; charset=utf-8 |
{
"id": 677,
"paymentId": 121425,
"status": "issued",
"invoicePaymentPageUrl": "https://qr.nspk.ru/AD10004ER7VBKGFA9I2PQUI50GG13K3C?type=02&bank=100000000017&sum=285000&cur=RUB&crc=58B8"
}
code | message | userMessage |
|---|---|---|
00299998 | Validation error | Не пройдена валидация данных |
00299999 | An unexpected error has occurred | Непредвиденная ошибка |
01000001 | Invalid certificate | Сертификат не прошел проверку |
01000002 | Inactive merchant | Мерчант не активный |
01000004 | Service not available | Выбранный сервис недоступен мерчанту |
06005101 | Validation error | Не пройдена валидация данных |
06005102 | Authorization Error | Ошибка авторизации |
06005103 | An unexpected error has occurred | Непредвиденная ошибка |