Pay

If you prefer to use your own interface for the payer instead of the ready-made web interface from Freedom Pay Gateway, you can use this method.

To get started with this method, you first need to use the Init method (described above) to obtain the pg_payment_id

Then, you can use the Pay method to initiate the payment process, and in the request to the Freedom Pay Gateway, you will need to pass the previously obtained pg_payment_id

Interaction diagram

Status: success/error/pending

Merchant_API_V3-Mobile balance pay.drawio.png

Request

Body Params multipart/form-data

pg_merchant_id

integer

required

Merchant ID in {{project}}
Issued upon connection

pg_payment_id

number

required

Transaction ID

pg_abonent_phone

number

required

Customer's phone to be charged

Example:

77077777777

pg_payment_system_code

enum<string>

optional

Unique mobile operator code.

Allowed values:

ACTIVKZTALTELKZTBEELINEKZTKCELLKZTTELE2KZT

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/xml

Body

pg_status

string

required

Shows the result of the query.

Status Description:

ok: The write-off was successful.

need_approve: Confirmation required.

error: Debit error.

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.

Example

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <pg_status>string</pg_status>
  <pg_payment_id>0</pg_payment_id>
</root>

Interaction diagram#

Request

Request samples

Responses

Interaction diagram