Approve

POST

https://api.freedompay.kz/mfs/approve

This method is required when working with the "Pay" method to send a request for OTP code confirmation (see the diagram above)

Request

Body Params multipart/form-data

pg_merchant_id

integer

required

Merchant ID in {{project}}
Issued upon connection

pg_payment_id

integer

required

Transaction ID

pg_approval_code

string

required

One-time OTP code sent by SMS to the payer's number

Example:

077587

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

curl --location --request POST 'https://api.freedompay.kz/mfs/approve' \
--form 'pg_merchant_id=""' \
--form 'pg_payment_id=""' \
--form 'pg_approval_code="077587"' \
--form 'pg_salt=""' \
--form 'pg_sig=""'

Responses

🟢200Success

application/xml

Body

pg_status

string

required

Shows the result of query execution.

Status Description:

ok: Debit successful.

process: Debit to process.

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>

Modified at 2025-03-24 15:12:01

Pay

Resend code