Skip to content

TOKEN Notification Format

Headers

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

Body Parameters

Parameter Description Type When present
type Notification type — only TOKEN string Always
version Notification version string Always
token Token description object Always

token

Parameter Description Type When present
status Operation status object Always
merchantSiteUid Merchant’s site identifier string Always
account Client identifier specified in payment token request string Always
value Payment token string When operation is successful
expiredDate Payment token expiration date string When operation is successful
tokenizationSource Tokenization source information object Always
bankMemberId Customer’s bank identifier string When operation is successful

status

Parameter Description Type When present
value Notification status string Always
changedDateTime Notification status change date and time URL-encoded string
YYYY-MM-DDThh:mm:ssZ
Always
rejectReason Rejection reason string If the operation was rejected

tokenizationSource

Parameter Description Type When present
type Tokenization source type string Always
uid Tokenization source ID string Always

Notification Body Example

{
  "token": {
    "status": {
      "value": "CREATED",
      "changedDateTime": "2023-01-01T10:00:00+03:00"
    },
    "merchantSiteUid": "test-00",
    "account": "test",
    "value": "d28a4ff8-548d-4536-927d-fc01123bebbf",
    "expiredDate": "2029-01-01T10:00:00+03:00",
    "tokenizationSource": {
      "type": "QR_CODE",
      "uid": "100220001"
    },
    "bankMemberId": "100000000008"
  },
  "type": "TOKEN",
  "version": "1"
}
{
  "token": {
    "status": {
      "value": "REJECTED",
      "changedDateTime": "2023-01-01T10:00:00+03:00"
    },
    "merchantSiteUid": "test-00",
    "account": "test",
    "tokenizationSource": {
      "type": "QR_CODE",
      "uid": "14012000011"
    }
  },
  "type": "TOKEN",
  "version": "1"
}