Redirect back
KZ
https://api.freedompay.kz
KZ
https://api.freedompay.kz
POST
{{success_url}} or {{failure_url}}
pg_success_url after a successful payment, to pg_failure_url after a failed one.Return to the site flow
pg_result_url and the return of the client are independent: either can come first.Parameters by payment page
| Page | Parameters |
|---|---|
| Payment page (Create payment) | pg_order_id, pg_payment_id, pg_salt, pg_sig: after a successful and after a failed payment. |
Payment page with a template (pg_template) | No parameters: identify the order by your URL, for example https://merchant.example.com/order/1001/success. |
| Payment frame (Create payment in a payment frame) | After a success: pg_order_id, pg_payment_id, pg_salt, pg_sig. After a failure: pg_order_id, pg_failure_code, pg_failure_description and your parameters without the pg_ prefix, without a signature. |
pg_success_url_method / pg_failure_url_method of the payment request, or the method from the merchant settings, GET by default.Result
| What the client opens | Meaning | Next step |
|---|---|---|
pg_success_url | The payment is successful. | Show the order with the status that you know from Result notify. If the notification has not come yet, show «payment is being processed» and request Get payment status. |
pg_failure_url | The payment failed. | Show the order and offer to pay again with a new payment. |
Request example
pg_success_url = https://merchant.example.com/payment/success):GET https://merchant.example.com/payment/success?pg_order_id=order-1001&pg_payment_id=1022123804618&pg_salt=m8Tz2Qw5Lx1Rk7Vb&pg_sig=d905ad1f9466fff09015ccc3530b27d9Request
Header Params
Body Params application/x-www-form-urlencoded