Перейти к содержанию

Формат уведомления CHECK_CARD

Заголовки

  • Signature: XXX
  • Accept: application/json
  • Content-type: application/json

Параметры тела уведомления

Поле Описание Тип В каких случаях используется
type Тип уведомления — только CHECK_CARD string Всегда
version Версия уведомления string Всегда
checkPaymentMethod Описание результата проверки карты object Всегда

Формат объекта checkPaymentMethod

Поле Описание Тип
checkOperationDate Дата проверки карты URL-закодированная строка
ГГГГ-ММ-ДДTчч:мм:ссZ
requestUid Идентификатор операции проверки карты string
status Статус проверки карты string
isValidCard Признак доступности карты для платежей boolean
threeDsStatus Статус дополнительной аутентификации при проверке карты string
paymentMethod Информация о средстве платежа object
cardInfo Информация о карте object
createdToken Объект с информацией о платёжном токене, выпущенном вместе с проверкой карты object
merchantSiteUid Строковый идентификатор сайта ТСП в QIWI Кассе string

Формат объекта paymentMethod

Поле Описание Тип
type Тип метода оплаты string
maskedPan Маскированный PAN карты string
cardExpireDate Срок действия карты string
cardHolder Имя держателя карты string

Формат объекта cardInfo

Поле Описание Тип
issuingCountry Код страны эмитента string(3)
issuingBank Банк-эмитент string
paymentSystem Тип платёжной системы string
fundingSource Тип карты string
paymentSystemProduct Категория карты string

Формат объекта createdToken

Поле Описание Тип
token Платёжный токен карты string
expiredDate Дата окончания срока действия платёжного токена string
name Маскированный номер карты, для которой выпущен платёжный токен string
account Идентификатор покупателя, указанный при выпуске платёжного токена string

Пример тела уведомления

Пример тела уведомления CHECK_CARD
{
    "checkPaymentMethod": {
        "status": "SUCCESS",
        "isValidCard": true,
        "threeDsStatus": "PASSED",
        "cardInfo": {
            "issuingCountry": "RUS",
            "issuingBank": "Альфа-банк",
            "paymentSystem": "MASTERCARD",
            "fundingSource": "PREPAID",
            "paymentSystemProduct": "TNW|TNW|Mastercard® New World—Immediate Debit|TNW|Mastercard New World-Immediate Debit"
        },
        "createdToken": {
            "token": "7653465767c78-a979-5bae621db96f",
            "name": "54**********47",
            "expiredDate": "2022-12-30T00:00:00+03:00",
            "account": "acc1"
        },
        "requestUid": "uuid1-uuid2-uuid3-uuid4",
        "paymentMethod": {
            "type": "CARD",
            "maskedPan": "54************47",
            "cardHolder": null,
            "cardExpireDate": "12/2022"
        },
        "checkOperationDate": "2021-08-16T14:15:07+03:00",
        "merchantSiteUid": "test-00"
    },
    "type": "CHECK_CARD",
    "version": "1"
}