Prefunded Withdrawal — New Request Fields

`POST /v1/customers/{customer_id}/withdrawals`

Added 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_id in 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`

Added 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_id in 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.

Changelog

v1.0.12

Prefunded Withdrawal — New Request Fields

v1.0.11

List Customers Endpoint Pagination Enhancement