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": "7077070707",
  "first_name": "Ivan",
  "last_name": "Ivanov",
  "card_token": "00000000-0000-0000-0000-000000000000",
  "request_id": "9a1c6959-2188-4292-a48e-aeb586204676"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kz/v5/card-api/external/cardholder_validate' \
--header 'X-JWS-Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "user_phone": "7077070707",
  "first_name": "Ivan",
  "last_name": "Ivanov",
  "card_token": "00000000-0000-0000-0000-000000000000",
  "request_id": "9a1c6959-2188-4292-a48e-aeb586204676"
}'

Responses

🟢200Success

application/json

Body

Examples

SuccessError

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

🟠422Unprocessable Entity

Modified at 2025-07-09 06:31:09

Transaction info

Set limits