Card

Request

Body Params multipart/form-data

pg_merchant_id

string

required

Merchant ID in {{project}}
Issued upon connection

Example:

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

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_user_id

string

optional

User ID in the merchant system

pg_payment_to

integer

required

Recipient's card number

>= 13<= 20

pg_card_name

string

optional

Name and surname of card holder

Example:

John Doe

pg_post_link

string

required

URL to which payment status response is sent

pg_salt

string

required

A random string consisting of arbitrary numbers and Latin letters

pg_sig

string

required

Request signature

Example:

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/p2p2nonreg' \
--form 'pg_merchant_id="{{paybox_merchant_id}}"' \
--form 'pg_order_id=""' \
--form 'pg_amount=""' \
--form 'pg_currency=""' \
--form 'pg_description=""' \
--form 'pg_user_id=""' \
--form 'pg_payment_to=""' \
--form 'pg_card_name="John Doe"' \
--form 'pg_post_link=""' \
--form 'pg_salt=""' \
--form 'pg_sig="{{paybox_signature}}"'

Responses

🟢200Success

application/xml

Body

pg_payment_id

integer

required

pg_merchant_id

integer

required

pg_order_id

string

required

pg_status

string

required

pg_balance

number

required

pg_payment_amount

number

required

pg_reference

string

required

pg_payment_date

object

required

pg_salt

string

required

pg_sig

string

required

Example

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_payment_id>7777777777</pg_payment_id>
    <pg_merchant_id>9970</pg_merchant_id>
    <pg_order_id>ORD12345</pg_order_id>
    <pg_status>ok</pg_status>
    <pg_balance>500000</pg_balance>
    <pg_payment_amount>1000</pg_payment_amount>
    <pg_payment_date>2024-09-02T12:19:01+00:00</pg_payment_date>
    <pg_reference>FSDUNJFA244324</pg_reference>
    <pg_salt>YtfwCGiBHsFLpYGk</pg_salt>
    <pg_sig>ccee466c01c2332d8a065d6108fd686b</pg_sig>
    <pg_datetime>2024-09-02T12:19:01+00:00</pg_datetime>
</response>

🟢200Error

🟢200Invalid Signature

Interaction diagram#

Request

Request samples

Responses

Interaction diagram