Create payment page with any amount

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

To limit the amount, pass pg_amount_interval_from and pg_amount_interval_to.

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.

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

Test cards: see Gateway API Overview.

Payment flow

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

Example

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>ok</pg_status>
    <pg_payment_id>1016061000059</pg_payment_id>
    <pg_redirect_url>https://customer-regress.freedom-pay.dev/any_amount?customer=01a14487-6c9a-7198-9f48-87c514c61f3f</pg_redirect_url>
    <pg_redirect_url_type>need data</pg_redirect_url_type>
    <pg_salt>L2kvmRxsxeHnnrBs</pg_salt>
    <pg_sig>e5bdd8903f2c14fbc56a18c09f93b02c</pg_sig>
</response>

🟢200Error

Create payment page with any amount

Payment flow#

Errors#

Request example#

Request

Responses

Payment flow

Errors

Request example