Для платежа с рекаррингом дополнительно к разделу уведомление о создании токена добавляется этот раздел.
В настоящий момент добавлен функционал отключения платежного токена.
Платежные токены имеют ограничение по количеству повторных попыток оплаты не завершившихся успешно.
Отключение платежного токена происходит, если исчерпаны повторные попытки списания, (например, из-за недостаточности средств), или результатом оплаты стала ошибка, после которой повторное списание бесполезно(например, банк заблокировал карту).
После отключения будет отправлено соответствующее уведомление.
Настройки
Так же как и с платежами, требуется от партнера получить заранее URL-адрес на который отправлять информацию о созданном платежном токене. Платежный шлюз МТС отправляет на указанный в профиле URL уведомление пока только по факту отключения платежного токена.
Всё что указано до {paymenttokenId} это информация от вас. Мы же к вашему адресу добавляем идентификатор платежного токена "{paymenttokenId}" и указание, что платежный токен отключен"/disabled".
Уведомление отправляется как HTTP-запрос на адрес, указанный в настройках Партнера, в следующем формате:
POST |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| paymenttokenId | string[32] | да | ID платежного токена |
| Request-Id | guid | да | Идентификатор конкретного запроса |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
disabledAt | dateTime | да | Дата и время деактивации токена |
errorCode | string | да | Код ошибки, полученной по неуспешной операции |
errorMessage | string | да | Описание ошибки (message ошибки) |
Content-Type: application/json; charset=utf-8 |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
result | string | да | SUCCESS|ERROR |
| errorMessage | string | нет | Если result=ERROR |
POST {merchant_url}/8b3c3f9b-5a93-4a17-80c9-3da5cc495b27/disabled HTTP/1.1 |
{
"disabledAt": "2023-02-22 12:25:58"
"errorCode": "07000004",
"errorMessage": "что-то пошло не так"
}
Content-Type: application/json; charset=utf-8 |
{
"result": "ERROR",
"errorMessage": "что-то пошло не так"
}
Коды и описание представлено в таблице:
code | message | User message |
|---|---|---|
02007023 | The system cannot process the payment. extSystemErrorCode: [errorCode] | Ваш банк отклонил платёж |
| 02007025 | User is blocked. extSystemErrorCode: [errorCode] | Пользователь заблокирован |
| 02007026 | The transaction was declined by the cardholder | Операция отклонена держателем карты |
| 02005029 | PCEK: user id and binding id does not match. extSystemErrorCode: [errorCode] | Некорректная связка пользователя и способа оплаты |
| 02005031 | PCEK: invalid provider or provider configuration. extSystemErrorCode: [errorCode] | Оплата через выбранный способ оплаты временно недоступна |
| 02005049 | PCEK: payment from billing account is not available. extSystemErrorCode: [errorCode] | Оплата со счёта телефона временно недоступна |
| 02005041 | PCEK: binding is not found. extSystemErrorCode: [errorCode] | Способ оплаты потерялся. Выберите другой и попробуйте снова. |
| 02005062 | Bank issuer: recurring operations are not available for this card. extSystemErrorCode: [errorCode] | Ваш банк отклонил платёж |
| 02005065 | Bank acquirer: fatal general error. extSystemErrorCode: [errorCode] | Банк отклонил платёж |
| 02005061 | Bank acquirer: general error. extSystemErrorCode: [errorCode] | Банк отклонил платёж |
| 02005018 | Bank issuer: potential fraud or safety restriction. extSystemErrorCode: [errorCode] | Оплата по выбранной карте недоступна |
| 02005030 | Fraudcontrol: exceeding limits. extSystemErrorCode: [errorCode] | Платёж отклонен системой безопасности |
| 02005016 | Bank acquirer: invalid merchant or terminal. extSystemErrorCode: [errorCode] | Оплата через выбранный способ оплаты временно недоступна |
| 02005036 | Bank issuer: payment restriction. extSystemErrorCode: [errorCode] | Ваш банк ограничил оплату с выбранной карты |
| 02005060 | Bank issuer: potential fraud or safety restriction. extSystemErrorCode: [errorCode] | Ваш банк отклонил платеж. Ограничения на карте. |