Get payment status

Returns the current state of a payment by its ID or by the merchant's order number.
The X-Action header must be gateway.payment.status.
The response can be empty with X-Request-Status = process: the payment data is being prepared, repeat the request in a few seconds.
Child payments (refunds and reversals) can be requested by their own ID.

Payment status flow

one-step — auto_clearing = true, two-step — auto_clearing = false.
create, clearing, reverse, refund — the methods gateway.payment.create, gateway.payment.clearing, gateway.payment.reverse, gateway.payment.refund.
3DS — the client must pass 3DS authentication at 3ds.acs_url.
A refund does not change the status of the payment: refunds are listed in refund_payments.
A partial clearing reverses the rest automatically: it is listed in reverse_payments.

application/json

Headers

Bodyapplication/json

Since the API operates asynchronously, whenever the payment status is returned as process, you must continuously query the payment status until you receive a final status such as approved or success.

{
  "id": "01a1304b-4b7e-7ef7-8bd6-3cab7702d22e",
  "status": "approved",
  "amount": 100,
  "created_at": "2026-10-12T13:26:43.326981454Z",
  "order_id": "order_1001",
  "clearing": {
    "cleared": false,
    "amount": 0
  },
  "from": {
    "card": {
      "token": "af6ada05-5599-41aa-9b8c-227233e58f2e",
      "brand": "UNIONPAY"
    }
  },
  "additional": {
    "approval_code": "432914",
    "reference": "420101893936",
    "intreference": "5DF022F3C632F404"
  },
  "3ds": {
    "acs_url": "",
    "flow_type": "F"
  }
}

Request

Responses