Capturing the funds of a payment completes the transaction. In the case of a credit card payment, it only occurs after a successful authorization. The hold on the funds is settled and the money is transferred to the merchant. If capture fails — for example, due to a network error or a problem at the payment processor — the transaction is marked CAPTURE_FAILED and can be retried.

Capturing an Authorized Transaction

This call assumes the transaction has already been authorized, so the customer and payment details were captured earlier in the flow. You only need the transaction’s identifier; a metadata object may be included optionally.

POST /v1/payment-proxy/transactions/{transaction_id}/capture

{
    "metadata": { "note": "captured after fulfillment" }
}

A successful capture moves the transaction to CAPTURED. If you instead want to authorize and capture in a single request, see Auth + Capture Payment. To return funds after a capture, see Refund a Payment.