Secret data (version 2)

POST

https://api.freedompay.kz/v5/card-api/card/secret_info_v2

The method is designed to retrieve confidential information about a payment card, including the full card number (PAN) and the security code (CVC).
Usage:
This method is required in cases where card details need to be displayed or transmitted for payment transactions.
Security:
The card_pan and card_cvc parameters contain encrypted data encoded in Base64 format. Encryption is performed using the RSA algorithm with PKCS#1 v1.5 padding and the partner's RSA public key. To retrieve the original values, the data must first be Base64-decoded, then decrypted using the partner's RSA private key with PKCS#1 v1.5 padding.

Request

Body Params application/json

card_id

string

required

Identifier of the card in Freedom Processing.

Example

{
  "card_id": "string"
}

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/card/secret_info_v2' \
--header 'Content-Type: application/json' \
--data-raw '{
    "card_id": "string"
}'

Responses

🟢200Success

application/json

Body

status

string

required

Status of the request. Possible values:

ok: Request completed successfully.

error: Request completed with an error.

request_status

string

required

Execution status of the request. Refer to the documentation.

card_pan

string

required

Encoded full Сard number (PAN)

card_cvc

string

required

Encoded Card CVV/CVC/CVC2 code

string

required

Date and time of the request (format: RFC 3339, YYYY-MM-DDThh:mm:ss+hh:mm).

Example

{
  "status": "string",
  "request_status": "string",
  "card_pan": "string",
  "card_cvc": "string",
  "dt": "string"
}

Secret data

Statement