Для платежа с рекаррингом дополнительно к разделу уведомление о платеже добавляется этот раздел.
В структуру уведомления по платежу добавляется параметр paymentTokenId:
Поле | Тип | Обязат. | Описание |
|---|---|---|---|
paymentTokenId | guid | нет | Идентификатор платежного токена в ПШ |
Пример JSON:
{
"id": 223205,
"amount": 10.0,
"currency": "643",
"status": "EXECUTED",
"paymentTime": "2021-05-05T13:07:46.955962",
"serviceId": 6340,
"serviceParams": {
"id1": "108882256562",
"NUMBER": "79157802494",
"payerEmail": "test@mts.ru"
},
"sessionId": "a8d288ccf2db41ada7fac6f43831be59",
"extClientId": "4673804f-663c-4ab4-9888-78e9f68ffd3d",
"paymentTokenid": "dd0ce6e2b9fb4ea191a37035ab8240a9",
"processingId": "13446192811"
}
Платежный шлюз со своей стороны предоставляет список IP адресов (если требуется), с которых могут быть отправлены уведомления.
Дополнительную проверку подлинности сообщения можно выполнить с помощью запроса: Информация о платежном токене.
Так же как и с платежами, требуется от партнера получить заранее URL-адрес на который отправлять информацию о созданном платежном токене. Платежный шлюз МТС отправляет на указанный в профиле URL уведомление пока только по факту создания платежного токена.
Всё что указано до {paymenttokenId} это информация от вас. Мы же к вашему адресу добавляем идентификатор платежного токена "{paymenttokenId}" и указание, что платежный токен создан "/created".
Уведомление отправляется как HTTP-запрос на адрес, указанный в настройках Партнера, в следующем формате:
POST |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| paymenttokenId | guid | да | ID платежного токена |
| Request-Id | guid | да | Идентификатор конкретного запроса |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| sessionId | string[32] | условно | Идентификатор сессии, по которой был создан платежный токен
|
| paymentToolInfo | object | да | Данные о платежном инструменте |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
type | string(enum) | да | Тип способа оплаты
|
| card | object | нет | Структура данных карты (будет заполняться для type=mtsBankCard, boundCard |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
expiryMonth | int32[2] | да | Месяц действия карты (MM) |
| expiryYear | int32[4] | да | Год действия карты (YYYY) |
| id | int64 | условно |
|
| type | string | да | Тип платежной системы (VISA, MASTERCARD, MAESTRO, MIR, CUP и др.) |
maskedPan | string | да | Маскированный номер карты |
Уведомление считается принятым, если получатель ответил на запрос кодом HTTP 200 OK.
Заголовок ответа
Content-Type: application/json; charset=utf-8 |
Тело ответа
Поле | Тип | Обяз. | Описание |
result | string | да | SUCCESS|ERROR |
errorMessage | string | нет | Если result=ERROR |
POST {merchant_url}/paymenttoken/246da738-3947-408c-9d40-5c39ad16cc12/created HTTP/1.1 |
{
"sessionId" : "a8d288ccf2db41ada7fac6f43831be59"
}
Content-Type: application/json; charset=utf-8 |
{
"result": "ERROR",
"errorMessage": "что-то пошло не так"
}