curl --request POST \
--url https://sandbox.api.engagexpay.com/v3/batch/transactions/commit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--data '
[
{
"beneficiary_id": "d6ae4ea6-0482-47ab-a895-02e50ea6358b",
"source_amount": 530,
"source_currency": "USD",
"deduct_from": "PREFUNDED_BALANCE",
"remarks": "Monthly salary payment"
}
]
'{
"data": {
"id": "3b1d73c0-0000-0000-0000-51aa2461f1"
}
}Batch Transfer
Execute Batch Transfer V3
Execute multiple transfer payouts in a single batch operation.
POST
/
v3
/
batch
/
transactions
/
commit
curl --request POST \
--url https://sandbox.api.engagexpay.com/v3/batch/transactions/commit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--data '
[
{
"beneficiary_id": "d6ae4ea6-0482-47ab-a895-02e50ea6358b",
"source_amount": 530,
"source_currency": "USD",
"deduct_from": "PREFUNDED_BALANCE",
"remarks": "Monthly salary payment"
}
]
'{
"data": {
"id": "3b1d73c0-0000-0000-0000-51aa2461f1"
}
}Any fiat transactions submitted between 9:30 AM and 5:30 PM ET on a weekday are processed the same day. Transactions submitted outside these hours or on weekends will be settled the next business day.
This endpoint can only be used with beneficiaries created with
auto_settlement set to false.- Each transaction must include exactly one of
source_amountordestination_amount(not both) source_amount: Minimum 500 cents (e.g. 500 = $5.00)- Only
PREFUNDED_BALANCEtransactions are eligible for refunds if they fail
What changed from V1
| V1 | V3 |
|---|---|
| No idempotency header | X-Idempotency-Key header required. |
X-Idempotency-Key (up to 255 characters) with every new request. A UUID works well:
X-Idempotency-Key: 3f1c9a2e-7b4d-4e8a-9c21-5d6f0b8e1a47
POST /v1/batch/transactions/commit.Authorizations
Bearer token authentication. Obtain token from Issue a Token endpoint
Headers
Unique key that identifies this request. Use a new key for each new request. Maximum 255 characters.
Maximum string length:
255Body
application/json
Example:
"d6ae4ea6-0482-47ab-a895-02e50ea6358b"
Example:
"USD"
Available options:
PREFUNDED_BALANCE, LIQUIDATION_ADDRESS Amount in cents (e.g. 530 = $5.30). Minimum 500 cents.
Required range:
x >= 500Example:
530
Example:
62000
Example:
"Monthly salary payment"
Response
Batch created successfully
Show child attributes
Show child attributes
⌘I