Introduction

Intro

FreedomPay provides an opportunity to issue a virtual payment card in one of the partner banks.

Query Mechanics

Request method	Request body format	Request URL
POST	JSON	https://api.freedompay.kg

Request Header

Name	Value	Description
Content-type	application/json	Request body format
Request-Id	unique string	Request unique string
Auth-Id	int	Merchant unique ID
Sign	string	Request signature

Request-Id must be unique. If duplicates are found, an error will be returned and the request will not be processed.

Request Signature

Each request must be signed. The signature is passed to the Headers parameter Sign.
The ID of the user making the request is also passed to Headers, the Auth-Id parameterz

Signature Generation Process:

JSON request must be in one line, without hyphens.

Add the merchant's secret key to the end of the JSON (provided by the manager).

Calculate the SHA256 hash of the received string and add it to the request headers, the Sign parameter.

Example of a string before calculating SHA256:

{"cardholder_name":"IVANOV IVAN IVANOVICH","phone":"79651234567","product_code":"1","card_id":555}some_secret_string

curl --location --request GET 'some_url.com' \
--header 'Request-Id: 5aac88a2-d16d-4601-927c-8b02bf44375c' \
--header 'Auth-Id: 12345' \
--header 'Sign: 4f64cb8c08eca4cffdbd6ee810dce21928132ea96c3b52a3b32f74be98b766b4' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardholder_name": "IVANOV IVAN IVANOVICH",
    "phone": 79651234567,
    "product_code": 1,
    "card_id": 555
}'

Intro#

Query Mechanics#

Request Header#

Request Signature#

Signature Generation Process:#

Example of a string before calculating SHA256:#

Intro

Query Mechanics

Request Header

Request Signature

Signature Generation Process:

Example of a string before calculating SHA256: