Easy Labs
ReferenceAPI ReferencePaymentsAuthorization

Capture an authorization

Capture a previously created authorization. Amount must be > 0 and cannot exceed the authorized amount.

POST
/v1/api/authorizations/{id}/capture

Authorization

apiKey
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Path Parameters

id*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/v1/api/authorizations/string/capture" \  -H "Content-Type: application/json" \  -d '{    "amount": 10000  }'
{
  "success": true,
  "timestamp": "2026-02-27T00:00:00.000Z",
  "message": "Authorization captured successfully",
  "data": {
    "id": "AUxxxxxxxxxxxxxxxxxx",
    "amount": 10000,
    "state": "SUCCEEDED",
    "is_void": false,
    "transfer": "TRxxxxxxxxxxxxxxxxxx"
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}

Create an authorization

Create a Finix authorization (auth-only — no funds captured until /:id/capture). Body mirrors Finix's /authorizations payload. The merchant defaults to the API-key/JWT context but can be overridden for sub-merchant routing.

Void an authorization

Void a previously created authorization, releasing the held funds.