Skip to main content

Method cards-by-phone

URL: POST - /partner/card/list-by-phone

The method allows you to get a list of bank cards by phone number. The method returns a maximum of 5 bank card numbers of the client randomly (If the client has more than 5 bank cards registered by phone number, the method returns only 5 of them selected randomly).

Header parameters

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

Request parameters

ParameterTypeDescription
phone *stringClient's phone number

Request sample

curl POST '/partner/card/list-by-phone' \
--header 'client-id: system' \
--header 'client-secret: system123' \
--data '{
"phone": "998977000000"
}'

Response parameters

ParameterTypeDescription
dataarrayResponse data array (maximum 5 elements).
panstringBank card number
tokenstringBank card Token
holderstringFull name of the bank card holder
processingstringProcessing type
«UZCARD»
«HUMO»

Example response if successful

{
"data": [
{
"pan": "8600 12** **** 1234",
"token": "ASDPT6OBAWWTD3TKZVVSNIENUPUQVOQO",
"holder": "TE*** TE***",
"processing": "UZCARD"
},
{
"pan": "9860 13** **** 1234",
"token": "SDKPT6OBAWWTD3TKZVVSNIENUPUQVOQO",
"holder": "Ab*** Qw***",
"processing": "HUMO"
}
]
}

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