Get payment status

Returns the current state of a payment: status, amounts, captured and refunded amounts, card data, refunds and cancels.

Find the payment by pg_payment_id or by pg_order_id. If pg_payment_id is passed, pg_order_id is ignored. If several payments have the same pg_order_id, the latest one is returned.

Use it to get the final result when a method returned pending or process, or when a response was lost.

In JSON, pass pg_payment_id as a number: a string returns 9999.

How to read the response

Field	What it shows
`pg_status`	Result of this request: `ok`, or `pending` while the payment waits for 3DS authentication. `error` means that the request itself failed (see «Errors»).
`pg_payment_status`	Status of the payment: `new`, `waiting`, `process`, `success`, `error`.
`pg_captured`	`1`: the amount is captured, `0`: the amount is only blocked (two-step payment before the clearing) or released.
`pg_clearing_amount`	Captured amount.
`pg_refund_amount`	Total returned to the client as a negative number: refunds plus the released part (cancel, or the rest after a partial clearing).
`pg_refund_payments`, `pg_revoked_payments`	Refund and cancel operations of the payment.

A cancelled or refunded payment keeps pg_payment_status = success: check pg_captured, pg_refund_amount and the lists of operations.

Errors

The HTTP status is always 200; error responses are not signed.

`pg_error_code`	When	What to do
`1200`	Neither `pg_payment_id` nor `pg_order_id` is passed.	Pass one of them.
`11068`	The payment is not found: wrong ID or order ID, or the payment belongs to another merchant.	Check the request.
`9999`	`pg_payment_id` is passed as a string in JSON, or an internal error occurred.	Pass `pg_payment_id` as a number; repeat the request later.

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

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <pg_payment_id>1015054203207</pg_payment_id>
    <pg_order_id>acs-ab0ad944</pg_order_id>
    <pg_currency>KZT</pg_currency>
    <pg_status>ok</pg_status>
    <pg_payment_status>success</pg_payment_status>
    <pg_amount>100</pg_amount>
    <pg_clearing_amount>0</pg_clearing_amount>
    <pg_refund_amount>0</pg_refund_amount>
    <pg_user_email></pg_user_email>
    <pg_card_name></pg_card_name>
    <pg_user_phone></pg_user_phone>
    <pg_payment_date>2026-10-15T10:45:35Z</pg_payment_date>
    <pg_card_pan>6224-46XX-XXXX-XXX12</pg_card_pan>
    <pg_card_exp>12/30</pg_card_exp>
    <pg_card_brand>UP1</pg_card_brand>
    <pg_net_amount>75</pg_net_amount>
    <pg_reference>261015104535</pg_reference>
    <pg_captured>0</pg_captured>
    <pg_auth_code>992589</pg_auth_code>
    <pg_intreference>ae823d0c-0eba-4da9-bd0d-a913df1a8e66</pg_intreference>
    <pg_salt>P3ZzxpFhVUzlXy67zaLJEHHFiYPATK3o</pg_salt>
    <pg_sig>2443146d3716bef80ed7f102da185ce3</pg_sig>
    <pg_datetime>2026-10-15T10:45:35+00:00</pg_datetime>
</response>

🟢200Error

How to read the response#

Errors#

Request example#

Request

Responses

How to read the response

Errors

Request example