Cardholder validation

POST

https://api.freedompay.kz/v5/card-api/external/cardholder_validate

This method is used by partners to verify whether the cardholder’s data (first name, last name, and phone number) matches the information associated with a given card token. It returns a confidence score and a fraud suspicion flag

Request

Header Params

Body Params application/json

Example

{
    "user_phone": "string",
    "first_name": "string",
    "last_name": "string",
    "card_token": "0a748f37-9423-492c-a713-f006d3ab14bf",
    "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}

Responses

🟢200Success

application/json

Body

Examples

SuccessErrorValidation errorMissing X-JWS-Signature

{
    "status": "ok",
    "score": "44.37%",
    "fishy": 1,
    "dt": "2025-05-27T15:22:40Z"
}

🟠422Unprocessable Entity

Card tokenization

Close card