Result notify

Freedom Pay sends the result of the payment to pg_result_url of the payment request, or to the Result URL from the merchant settings.

Sent once the payment is final: successful (pg_result = 1) or failed (pg_result = 0).

On the payment page with a template (pg_template) a declined card does not finish the payment: the client can try again. The notification comes after a successful attempt, or with pg_result = 0 when pg_lifetime expires.

Signed with the payment secret key: check the signature before you act on the notification.

Use this notification to give the client the goods or the service: the client may not return to pg_success_url.

Common rules for all callbacks (method, signature, delivery, retries): see Callbacks Overview.

Result notification flow

The notification goes from the Freedom Pay server to your server: it does not depend on the browser of the client.

Result

Answer with HTTP 200 and an XML or JSON body with pg_status:

`pg_status` in your answer	Meaning	Next step
`ok`	You accepted the notification.	Nothing else is needed.
`rejected`	You refuse the successful payment, for example the order is already cancelled.	If `pg_can_reject = 1`, Freedom Pay refunds the payment to the client; if the payment system declines the refund, the payment stays successful, so check the result with Get payment status. If `pg_can_reject = 0`, the answer is ignored: the payment stays successful.

Any answer with HTTP 2xx means that the notification is delivered: a body without pg_status = rejected is not processed.

No answer within 30 seconds or an HTTP code other than 2xx: Freedom Pay repeats the notification after 15 minutes, then twice more every 30 minutes (4 attempts in total).

The same notification can come more than once: process it by pg_payment_id only once.

If the notifications do not come, request the result with Get payment status.

Request example

Successful payment, pg_result_url = https://merchant.example.com/payment/result.
One field per line for reading: in the POST body the fields are joined with & and the values are URL-encoded.

pg_order_id=order-1001
pg_payment_id=1022123804618
pg_amount=1000
pg_currency=KZT
pg_net_amount=970
pg_ps_amount=1000
pg_ps_full_amount=1000
pg_ps_currency=KZT
pg_description=Order 1001
pg_result=1
pg_payment_date=2026-11-01 12:30:15
pg_can_reject=1
pg_user_phone=77001234567
pg_need_phone_notification=0
pg_user_contact_email=client@example.com
pg_need_email_notification=0
pg_payment_method=bankcard
pg_reference=430512345678
pg_user_ip=192.0.2.10
pg_captured=1
pg_card_pan=4400-44XX-XXXX-4440
pg_card_exp=12/27
pg_card_owner=IVAN IVANOV
pg_card_brand=VI
pg_auth_code=123456
pg_salt=bR5xQ2mL8nT4vW1z
pg_sig=d3215040b6f972efd0946cb4f4efcebd

Failed payment:

pg_order_id=order-1002
pg_payment_id=1022123804619
pg_amount=1000
pg_currency=KZT
pg_net_amount=970
pg_ps_amount=1000
pg_ps_full_amount=1000
pg_ps_currency=KZT
pg_description=Order 1002
pg_result=0
pg_can_reject=0
pg_need_phone_notification=0
pg_need_email_notification=0
pg_payment_method=bankcard
pg_user_ip=192.0.2.10
pg_captured=0
pg_failure_code=99999
pg_failure_description=Неизвестная ошибка платежной системы
pg_salt=Kp3sW9dQ1xZ7mN2c
pg_sig=6264f93bdc6aca08be65ebe8b5a6141e

Result notification flow#

Result#

Request example#

Request

Responses

Result notification flow

Result

Request example