Skip to main content

Method card-register-verify

URL: POST - /card/api/v1/card/register/verify

The method allows you to confirm the registration of a client's bank card using a one-time confirmation code sent by SMS.

Header parameters

ParameterTypeDescription
client-id *authorizationUnique Partner ID
client-secret *authorizationUnique authentication key for VIA API

Request parameters

ParameterTypeDescription
verifyId *stringIdentification number for confirmation
verifyCode *stringConfirmation code

Request sample

curl POST '/card/api/v1/card/register/verify' \
--header 'client-id: system' \
--header 'client-secret: system123' \
--data '{
"verifyId": "83735515f8ea493fa7954dd6070767de",
"verifyCode": "005646"
}'

Response parameters

ParameterTypeDescription
first6stringThe first 6 numbers of the client's bank card
last4stringThe last 4 numbers of the client's bank card
expMonthstringCard expiration month
expYearstringCard expiration year
binstringIdentification code of the servicing bank
cardHolderstringName and Surname of the bank card holder
bankNamestringName of the bank
bankCodestringBank ID
tokenstringBank card token in the system
hashPanstringGenerated secret key of the bank card number
processingstringProcessing type
«UZCARD»
«HUMO»
typestringType of bank card service

Example response if successful

{
"first6": "860012",
"last4": "1234",
"expMonth": "01",
"expYear": "25",
"bin": "860012",
"cardHolder": "Xxxxx Yyyyyy",
"bankName": "Ravnaq Bank",
"bankCode": "Ravnaq",
"token": "VLH8VNWKE3SBBBZEKA86T5PF72ZNVOIC",
"hashPan": "ff70558a1182ccbe61d5591bea055d39349078e6",
"processing": "UZCARD",
"type": "PRIVATE"
}

Example response in case of error

{
"status": {
"code": "1234",
"message": "Error while executing the request"
},
"error": {
"path": "URL Path",
"message": {
"uz": "Error message in Uzbek",
"ru": "Error message in Russian",
"en": "Error message in English"
}
}
}