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 stringYYYY-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"
}