Freedom Pay

Issue card

POST

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

This method allows for the issuance of a single instant card, creating and activating it with the specified details.

Request

Body Params application/json

request_id

string

required

Unique request ID in the partner system (UUID).

branch_id

string

optional

Branch code. If not provided, the default branch is selected.

product_id

integer

required

Code of the product for the card to be issued.

client_id

string

required

Identifier of the client in Freedom Processing.

accounts

array[string]

optional

Array of information about accounts.

accounts.*.iban

string

optional

Account number.

accounts.*.currency

string

optional

Currency (alpha-3 code).

Example

{
    "request_id": "string",
    "branch_id": "string",
    "product_id": 0,
    "client_id": "string",
    "accounts": [
        "iban",
        "currency"
    ]
}

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/issue' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "string",
    "branch_id": "string",
    "product_id": 0,
    "client_id": "string",
    "accounts": [
        "iban",
        "currency"
    ]
}'

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.

string <date-time>

required

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

Example

{
    "status": "string",
    "request_status": "string",
    "dt": "2019-08-24T14:15:22Z"
}

Modified at 2025-04-21 05:34:33

Bulk issue

Issue plastic card