Create payment with any amount

Creates a payment without an amount and returns the link to the amount entry page: pg_redirect_url. Redirect the client to it: the client enters the amount and then pays on the standard payment page.

On the amount entry page the client also enters the order ID, phone number and email if they are not passed in the request.

To limit the amount, pass pg_amount_interval_from and pg_amount_interval_to: the page does not accept an amount outside the interval.

Until the client enters the amount, Get payment status returns pg_payment_status = new and pg_amount = 0.

The result of the payment comes to pg_result_url, see Result notify. After the payment the client is returned to pg_success_url or pg_failure_url, see Redirect back.

If the payment result is not received, get it with Get payment status.

Parameters without the pg_ prefix are passed back to pg_check_url and pg_result_url unchanged. Give them unique names that do not start with pg_.

Test cards: see Merchant API Overview.

Payment flow

Result

`pg_status`	Meaning	Next step
`ok`	The payment is created.	Redirect the client to `pg_redirect_url` and wait for the result at `pg_result_url`.
`error`	The request is rejected.	See «Errors» below.

Errors

The HTTP status is always 200; the error is returned in pg_error_code and pg_error_description. Error responses are not signed.
See Error codes.

Request example

Required fields only. pg_sig is calculated with the secret key test_secret_key.
Line breaks in the body are added for readability: send the body as one line.

Responses

🟢200Success

application/xml

Bodyapplication/xml

Examples

SuccessSuccess with QR code

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>ok</pg_status>
    <pg_payment_id>1023122203578</pg_payment_id>
    <pg_redirect_url>https://customer.freedompay.kz/any_amount?customer=01a169fc-e14c-72ad-be40-85c47b2d3bd6</pg_redirect_url>
    <pg_redirect_url_type>need data</pg_redirect_url_type>
    <pg_salt>Ew1MSJgyBSFKdLMr</pg_salt>
    <pg_sig>45b24a599f962ed4fa6149d2611359ba</pg_sig>
</response>

🟢200Error

Create payment with any amount

Payment flow#

Result#

Errors#

Request example#

Request

Responses

Payment flow

Result

Errors

Request example