Init

POST

https://api.freedompay.kz/init_payment.php

To invoke this method, the parameter pg_payment_method=mobile_commerce must be included in the request to the Freedom Pay Gateway

In this method, in response to the payment request, the Freedom Pay Gateway returns pg_redirect_url to a ready-made web interface for the payer to enter the necessary details to complete the payment

Interaction diagram

Status: success/error/pending

Merchant_API_V3-Mobile balance init.drawio.png

Request

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kz/init_payment.php' \
--form 'pg_merchant_id=""' \
--form 'pg_order_id="550e8400-e29b-41d4-a716-446655440000"' \
--form 'pg_amount=""' \
--form 'pg_currency=""' \
--form 'pg_description=""' \
--form 'pg_testing_mode=""' \
--form 'pg_lifetime=""' \
--form 'pg_language=""' \
--form 'pg_user_id="No65GFR755789T"' \
--form 'pg_user_ip="127.0.0.1"' \
--form 'pg_user_phone="77777777777"' \
--form 'pg_user_contact_email=""' \
--form 'pg_payment_method=""' \
--form 'pg_request_method=""' \
--form 'pg_check_url="https://site.com/check"' \
--form 'pg_result_url="https://site.com/result"' \
--form 'pg_success_url="https://site.com/success"' \
--form 'pg_failure_url="https://site.com/failure"' \
--form 'pg_site_url="https://site.com/return"' \
--form 'pg_success_url_method=""' \
--form 'pg_failure_url_method=""' \
--form 'pg_param1="Additional information"' \
--form 'pg_param2="Additional information"' \
--form 'pg_param3="Additional information"' \
--form 'pg_commission_discount=""' \
--form 'pg_commission_discount_fix=""' \
--form 'pg_commission_discount_percentage=""' \
--form 'pg_generate_qr=""' \
--form 'pg_idempotency_key="550e8400-e29b-41d4-a716-446655440000"' \
--form 'pg_salt=""' \
--form 'pg_sig=""'

Responses

🟢200Success

application/xml

Body

Example

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

Modified at 2025-03-24 12:46:52

Overview

Pay

Init

Interaction diagram#

Request

Request Code Samples

Responses

Interaction diagram