Card Verification Status

Returns current status of card verification and payment token issue.

For additional information, please see “Card Verification“

Request

GET /payin/v1/sites/{siteId}/validation/card/requests/{requestUid}

Path Parameters

Parameter	Required	Type	Description
siteId	Yes	string	Merchant site identifier
requestId	Yes	string	Unique request identifier for the original request in the merchant’s system

Headers

Header	Required	Type	Description
Authorization	Yes	string	API access key. Bearer [access-token]
Content-type	Yes	string	Request content. application/json
Accept	No	string	Response content. application/json

Request Example

Card verification status

GET /partner/payin/v1/sites/test-01/validation/card/requests/acd7bf20-22e2-4cbf-a218-38d90e9f29b9 HTTP/1.1
Accept: application/json
Authorization: Bearer 5c4b25xx93aa435d9cb8cd17480356f9
Content-type: application/json
Host: b2b-api.qiwi.com

Response

See also HTTP error codes

Successful Response Parameters

Parameter	Required	Type	Description
requestUid	Yes	string	Request identifier. Same as in the request
status	Yes	string	Card verification status
checkOperationDate	No	string	Verification date and time
isValidCard	No	boolean	Verification result. true — the card is valid for payments
threeDsStatus	No	string	3D-Secure status
cardInfo	No	object	Bank card information
requirements	No	object	Requirements for customer’s addtional verification
createdToken	No	object	Payment token data. Returns if the additional authentication 3D-Secure is not requieed, isValidCard=true and the account parameter was provided

Error Parameters

Parameter	Required	Type	Description
serviceName	Yes	string	Name of the service that produced the error
errorCode	Yes	string	Error code
description	Yes	string	Error description for the merchant
userMessage	Yes	string	Error description for the customer
dateTime	Yes	string	Error date and time
traceId	Yes	string	Error Log unique ID

Response Examples

Successful responseResponse with error 4xxResponse with error 5xx

{
  "requestUid": "acd7bf20-22e2-4cbf-a218-38d90e9f29b9",
  "status": "SUCCESS",
  "isValidCard": true,
  "threeDsStatus": "WITHOUT",
  "checkOperationDate": "2025-03-25T12:55:12+03:00",
  "cardInfo": {
    "issuingCountry": "643",
    "issuingBank": "Gazprombank",
    "paymentSystem": "MIR",
    "fundingSource": "DEBIT",
    "paymentSystemProduct": "details"
  },
  "createdToken": {
    "token": "1a77343a-dd8a-11eb-ba80-0242ac130004",
    "name": "111122******4444",
    "expiredDate": "2034-12-31T00:00:00+03:00",
    "account": "cat_girl"
  }
}

{
  "serviceName" : "payin-core",
  "errorCode" : "validation.error",
  "description" : "Validation error",
  "userMessage" : "Validation error",
  "dateTime" : "2022-03-05T11:49:59.166+03:00",
  "traceId" : "fd0e2a08c63ace83"
}

{
  "serviceName":"payin-core",
  "errorCode":"internal.error",
  "userMessage":"Internal error",
  "description":"Internal error",
  "traceId":"3fb3420ee1795dcf",
  "dateTime":"2020-02-12T21:28:01.813+03:00"
}