Create a transaction

POST

/customers/v1/transactions

Create a new transaction with the provided details.

Payout rails are verification-gated: when the client's verification program gates PAYOUT, the source wallet's holder must be verification-cleared — an unverified, restricted or suspended holder is declined with 400 (reason VERIFICATION_RESTRICTED / VERIFICATION_SUSPENDED or a blocked-pending-verification message), and a clearance outage returns a retriable 503 for enrolled clients (see the 503 response).

Request

Header Params

Body Params application/json

Examples

Inter Wallet (Synchronous) — $25.50External Beneficiary (Asynchronous) — $150.00

{
    "amount": 25.5,
    "reference": "dolore in",
    "metadata": {},
    "from": "ea95fda2-05cc-01e7-4a16-ade2d0bada83",
    "to": "abd5222d-5e66-8147-5e65-8ee84980f533",
    "payment_type": "INTER_WALLET"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Inter Wallet (Synchronous) — $25.50External Beneficiary (Asynchronous) — $150.00

curl --location '/customers/v1/transactions' \
--header 'Idempotency-Key: {{idempotency-key}}' \
--header 'x-client-id;' \
--header 'Content-Type: application/json' \
--data '{
    "amount": 25.5,
    "reference": "dolore in",
    "metadata": {},
    "from": "ea95fda2-05cc-01e7-4a16-ade2d0bada83",
    "to": "abd5222d-5e66-8147-5e65-8ee84980f533",
    "payment_type": "INTER_WALLET"
}'

Responses

🟢201Created

application/json

Transaction created. Payouts (AUD_DE_1/AUD_NPP_1/AUD_DD_1/AUD_DE_3/AUD_NPP_3/FX_SEND_1) are created PENDING and resolve asynchronously — subscribe to transaction-accept/transaction-decline webhooks.

Bodyapplication/json

Example

{
    "id": "9b1f05d8-f08f-4974-ae2b-df1e475e5024",
    "amount": 1,
    "asset": "AUD",
    "asset_class": "CURRENCY",
    "created_at": "2025-01-14T16:42:56.086Z",
    "external_id": "111",
    "from": "3d83ed2b-b760-4101-adf2-4f83ed57d366",
    "payment_type": "MANUAL_CREDIT",
    "reference": "in dolore nostrud sit velit",
    "status": "DECLINED",
    "to": "4e624f4c-d49c-4cb4-bda3-1c734042d134",
    "type": "RESERVATION",
    "updated_at": "2025-01-14T16:42:56.088Z",
    "metadata": {},
    "info": null,
    "program_id": null,
    "owner": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "mandate_id": null
}

🟢202Accepted

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴503Service Unavailable

Modified at 2026-09-15 01:24:19

Get all transactions

Get transaction by ID