Capture payment (clearing)

Debits funds held by a two-step payment (auto_clearing = false).
The X-Action header must be gateway.payment.clearing.
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.
The clearing is processed asynchronously: the response returns the payment with status process_clearing; get the final status via gateway.payment.status or gateway.request.status.
For a one-step payment (auto_clearing = true) clearing is not needed: the payment is debited at creation; to return the money use gateway.payment.refund.

Two-step payment flow

Requests to the payment system are processed asynchronously: the API responds immediately, the result is available via gateway.payment.status.
If a response is lost or returned with X-Request-Status = process, get the result via gateway.request.status with the X-Request-Id of that request.
A clearing with an amount less than the payment amount reverses the rest automatically (reverse_payments).

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