Token Pay - Freedom Pay

Request

Body Params multipart/form-data

pg_merchant_id

integer

required

Merchant ID in {{project}}
Issued upon connection

pg_order_id

string

required

Payment ID in the merchant system
It is recommended to keep this field unique

pg_amount

number

required

Payment amount in pg_currency

>= 0.01

pg_currency

string

optional

Currency in which the amount is specified

pg_description

string

required

Payment description
(These parameters may include parameters from other sections. For the effective operation of SecureBox, it is recommended to follow the validation guidelines and field examples from this section)

pg_language

string

optional

Error text language

pg_user_id

string

required

User ID in the merchant's system
(These parameters may include parameters from other sections. For the effective operation of SecureBox, it is recommended to follow the validation guidelines and field examples from this section)

pg_card_token

string

optional

Saved card token of the sender

pg_param1

string

optional

Additional parameter 1

pg_param2

string

optional

Additional parameter 2

pg_param3

string

optional

Additional parameter 3

pg_salt

string

required

Random string consisting of arbitrary numbers and Latin letters

pg_sig

string

required

Request signature

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.freedompay.kz/g2g/payment' \
--form 'pg_merchant_id=""' \
--form 'pg_order_id=""' \
--form 'pg_amount=""' \
--form 'pg_currency=""' \
--form 'pg_description=""' \
--form 'pg_language=""' \
--form 'pg_user_id=""' \
--form 'pg_card_token=""' \
--form 'pg_param1=""' \
--form 'pg_param2=""' \
--form 'pg_param3=""' \
--form 'pg_salt=""' \
--form 'pg_sig=""'

Responses

🟢200Success

application/xml

Body

pg_payment_id

integer

required

Payment ID

pg_status

string

required

ok

pg_merchant_id

integer

required

pg_order_id

string

required

pg_salt

string

required

pg_sig

string

required

pg_datetime

string

required

Example

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>ok</pg_status>
    <pg_payment_id>7777777777</pg_payment_id>
    <pg_merchant_id>9970</pg_merchant_id>
    <pg_order_id>ORD12345</pg_order_id>
    <pg_salt>some random string</pg_salt>
    <pg_sig>ccee466c01c2332d8a065d6108fd686b</pg_sig>
    <pg_datetime>2024-09-02T12:19:01+00:00</pg_datetime>
</response>