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

Body Params application/json

user_phone

string

required

User’s phone number

first_name

string

required

Cardholder’s first name

last_name

string

required

Cardholder’s last name

card_token

string <uuid>

required

Card token

request_id

string <uuid>

required

Unique request identifier

Example

POST /v5/partner/external/cardholder_validate  
Content-Type: application/json  
X-JWS-Signature: {JWS}  
{  
  "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 'Content-Type: application/json' \
--data-raw 'POST /v5/partner/external/cardholder_validate  
Content-Type: application/json  
X-JWS-Signature: {JWS}  
{  
  "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

status

string

required

Response status: "ok"

score

string

required

Confidence score (e.g., "44.37%")

fishy

integer

optional

Fraud suspicion flag: 0 (no), 1 (suspicious)

string

required

Response timestamp (UTC, ISO 8601 format)

Examples

Successful Response (200 OK)Response for Missing Data (200 OK)Validation Error (422 Unprocessable Entity)Missing JWS Signature Header (422 Unprocessable Entity)

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

Modified at 2025-06-11 07:28:26

Transaction info

Overview