Skip to content

CHECK_CARD Notification Format

Headers

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

Body Parameters

Parameter Description Type
type Notification type — only CHECK_CARD string
version Notification version string
checkPaymentMethod Card verification result description object

checkPaymentMethod

Parameter Description Type
checkOperationDate Card verification date URL-encoded string
YYYY-MM-DDThh:mm:ssZ
requestUid Card verification operation identifier string
status Card verification status string
isValidCard true means card can be charged boolean
threeDsStatus Additional authentication status on card verification string
paymentMethod Payment method object
cardInfo Card information object
createdToken Information on payment token issued with card verification object
merchantSiteUid Merchant’s site identifier string

paymentMethod

Parameter Description Type
type Payment method type string
maskedPan Masked PAN string
cardExpireDate Card expiration date string
cardHolder Cardholder name string

cardInfo

Parameter Description Type
issuingCountry Country code of the issuing bank string(3)
issuingBank Issuing bank string
paymentSystem Payment system type string
fundingSource Card type (debit/credit/…) string
paymentSystemProduct Card category string

createdToken

Parameter Description Type
token Payment token string
expiredDate Payment token expiration date string
name Masked PAN of the tokenized card string
account Customer identifier used when issuing the token string

Notification Body Example

CHECK_CARD notification body example
{
    "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"
}