Freedom Pay

Add

POST

https://api.freedompay.kg/v1/merchant/{{paybox_merchant_id}}/cardstorage/add

Request

Body Params multipart/form-data

pg_merchant_id

integer

required

Merchant ID in the system {{project}}.

pg_user_id

integer

required

User ID in the merchant system.

Example:

1234

pg_back_link

string

required

URL to redirect the user after adding a card.

Example:

http://site.kz/back

pg_salt

string

required

A random string consisting of arbitrary numbers and Latin letters.

Example:

some random string

pg_sig

string

required

Request signature.

pg_post_link

string

optional

pg_order_id

string

optional

Order ID in the merchant system

Example:

12345

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://api.freedompay.kg/v1/merchant/{{paybox_merchant_id}}/cardstorage/add' \
--form 'pg_merchant_id=""' \
--form 'pg_user_id="1234"' \
--form 'pg_back_link="http://site.kz/back"' \
--form 'pg_salt="some random string"' \
--form 'pg_sig=""' \
--form 'pg_post_link="";type=* URL to post the result.' \
--form 'pg_order_id="12345"'

Responses

🟢200Success

application/xml

Body

pg_payment_id

integer

required

The unique identifier of the payment transaction in {{project}}. Serves as a key for all further work with the transaction.

pg_merchant_id

integer

required

Merchant ID in the system {{project}}.

pg_order_id

string

required

Order ID in the merchant system.

pg_status

string

required

Shows the result of the query.

pg_redirect_url

string

required

URL to call in iframe or redirect (redirect).

pg_type

string

required

Transaction type.

pg_salt

string

required

Random string.

pg_sig

string

required

Request signature.

Example

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <pg_payment_id>0</pg_payment_id>
  <pg_merchant_id>0</pg_merchant_id>
  <pg_order_id>string</pg_order_id>
  <pg_status>string</pg_status>
  <pg_redirect_url>string</pg_redirect_url>
  <pg_type>string</pg_type>
  <pg_salt>string</pg_salt>
  <pg_sig>string</pg_sig>
</root>

Modified at 2025-02-03 10:08:06

Introduction

Add for payout