ReferenceAPI ReferencePaymentsAuthorization
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.
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
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/" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000, "currency": "USD", "source": "PIxxxxxxxxxxxxxxxxxx", "statement_descriptor": "ACME WIDGETS", "tags": { "order_id": "ord_abc123" } }'{
"success": true,
"timestamp": "2026-02-27T00:00:00.000Z",
"message": "Authorization created",
"data": {
"id": "AUxxxxxxxxxxxxxxxxxx",
"amount": 5000,
"currency": "USD",
"source": "PIxxxxxxxxxxxxxxxxxx",
"merchant": "MUxxxxxxxxxxxxxxxxxx",
"merchant_identity": "IDxxxxxxxxxxxxxxxxxx",
"state": "SUCCEEDED",
"is_void": false,
"created_at": "2026-02-27T00:00:00.000Z"
}
}{
"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
}
}