Capture payment (clearing)

Debits funds held by a two-step payment (auto_clearing = false).

The X-Action header must be gateway.payment.clearing.

Sign the request with X-JWS-Signature: see Async API Overview.

Clearing is possible once, only for a payment in status approved.

Without amount the full payment amount is debited. With a smaller amount the rest is reversed automatically: it is listed in reverse_payments.

A one-step payment (auto_clearing = true) is debited at creation: to return the money use gateway.payment.refund.

Two-step payment flow

Result

Response	Meaning	Next step
`status = process_clearing`	The clearing is accepted.	Get the final status with `gateway.payment.status`: the payment gets status `success`, `clearing.cleared = true`. If the response is lost, use `gateway.request.status`.
`{}`, `X-Request-Status: process`	The result is not ready yet.	Repeat the request in a few seconds with the same `X-Request-Id`.

Errors

A rejected clearing is returned with HTTP 400, status error and the error object.
The error is returned in error.code and error.description.

HTTP	`error.code`	When	What to do
`400`	`110691`	Invalid payment status: clearing is possible only for a two-step payment in status `approved` (not cleared, not reversed, not waiting for 3DS).	Get the payment status with `gateway.payment.status`.
`400`	`110741`	The clearing amount exceeds the payment amount.	Pass `amount` not greater than the payment amount.
`400`	`9400`	The body is not valid JSON.	Fix the request.
`401`	`9998`	The signature is invalid.	Check the signature: see Async API Overview.
`422`	`9403`	`id` is missing or is not a UUID, `amount` is less than 0.01, or a required header is missing. The reason is in `error.description`.	Fix the request.
`500`	`9999`	Internal error at the gateway entry point.	Repeat the request later with the same `X-Request-Id`.
`500`	`10000`	Internal error in payment processing.	Repeat the request later with the same `X-Request-Id`.

Responses

🟢200OK

application/json

Headers

Bodyapplication/json

Examples

Partial clearing acceptedFull clearing acceptedRepeated request (same X-Request-Id)Result not ready (X-Request-Status: process)

{
  "id": "01a133af-20c6-75d2-8c07-2bef4dc95212",
  "status": "process_clearing",
  "amount": 100,
  "created_at": "2026-10-13T05:14:37.638388726Z",
  "clearing": {
    "amount": 40
  }
}

🟠400Bad Request

🟠422Unprocessable Entity

🟠401Unauthorized

🔴500Internal Server Error

Capture payment (clearing)

Two-step payment flow#

Result#

Errors#

Request

Responses

Two-step payment flow

Result

Errors