v1.0.12
1 day ago by Frank Zhou
Prefunded Withdrawal — New Request Fields
POST /v1/customers/{customer_id}/withdrawals
POST /v1/customers/{customer_id}/withdrawalsAdded two optional fields to support prefunded withdrawals for both fiat and crypto assets:
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | No | Set to "prefunding" to fund the withdrawal from the main account on behalf of a sub-account. |
on_behalf_of | string | No | Sub-account customer ID. Required when mode is "prefunding". Must belong to the same entity. |
- Both fields must be provided together.
- The
customer_idin the path must be the main account (funder). - Supported:
USD(US_FEDWIRE),USDT(ETHEREUM),USDC(ETHEREUM).
Request example:
{
"idempotency_key": "unique-key-123",
"amount": "50.00",
"asset": "USDT",
"network": "ETHEREUM",
"wallet_address": "0x...",
"mode": "prefunding",
"on_behalf_of": "<sub-account-customer-id>"
}
Response includes mode, on_behalf_of, and funder_pid when applicable. These fields are omitted for normal withdrawals. Sponsored Withdrawal — New Request Fields
POST /v1/customers/{customer_id}/withdrawals
POST /v1/customers/{customer_id}/withdrawalsAdded two optional fields to support sponsored (prefunded) withdrawals for both fiat and crypto assets:
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | No | Set to "prefunding" to fund the withdrawal from the main account on behalf of a sub-account. |
on_behalf_of | string | No | Sub-account customer ID. Required when mode is "prefunding". Must belong to the same entity. |
- Both fields must be provided together.
- The
customer_idin the path must be the main account (funder). - Supported:
USD(US_FEDWIRE),USDT(ETHEREUM),USDC(ETHEREUM).
Request example:
{
"idempotency_key": "unique-key-123",
"amount": "50.00",
"asset": "USDT",
"network": "ETHEREUM",
"wallet_address": "0x...",
"mode": "prefunding",
"on_behalf_of": "<sub-account-customer-id>"
}
Response includes mode, on_behalf_of, and funder_pid when applicable. These fields are omitted for normal withdrawals.