Skip to main content
POST
/
partner-connect
/
transactions
/
capture
Error
A valid request URL is required to generate request examples
{
  "transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "captured",
  "amountCaptured": 100,
  "currency": "USD",
  "captureDate": "2025-03-19T09:51:17.009Z"
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Requires the transactionId of the locked transaction and the amount to capture in the request body.

transactionId
string<uuid>
required

Unique transaction identifier.

amount
number<float>
required

Amount to capture. Can be equal or less than authorized amount.

Required range: x >= 0.01Must be a multiple of 0.01
Example:

100

Response

Transaction successfully captured. Funds have been transferred from the customer's account to the merchant's account. The transaction status has been updated to captured.

This confirms that the payment has been finalized and the merchant can now fulfill the order or provide the service.

transactionId
string<uuid>
required

The unique identifier (UUID) of the captured transaction (same as the authorization ID).

status
enum<string>
required

The updated status of the transaction, which will be captured.

Available options:
locked,
captured,
void,
refunded
amountCaptured
number<float>
required

The actual amount that was successfully captured, formatted to 2 decimal places.

Required range: x >= 0.01Must be a multiple of 0.01
Example:

100

currency
string
required

Currency code (ISO 4217) of the captured amount.

Required string length: 3
Example:

"USD"

captureDate
string<date-time>
required

The timestamp (ISO 8601 format) when the transaction capture was successfully processed.

cardId
string<uuid>

The unique identifier (UUID) assigned to the successfully bound card. Store this cardId securely, as it is required to reference this card in all subsequent transaction requests (/verify, /purchase, etc.).

refId
string

A unique transaction identifier provided for the client’s reference. It can be used to track or correlate transactions

Example:

"CT6KQDDEC2"