Create withdrawal
POST/customers/:code/withdrawals
Submit a withdrawal (internal transfer from customer sub-account). Processing is not instant and may take a few seconds. Once completed, the withdrawal will appear in the customer's transaction list.
A withdrawal above the customer's available balance is rejected with
400 INSUFFICIENT_FUNDS.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 429
- 500
Withdrawal created
Bad request — validation failed, invalid parameters, or the request
was rejected due to a business rule violation (e.g.
INSUFFICIENT_FUNDS when a transfer exceeds the available balance).
Authentication required or credentials invalid
Insufficient permissions for the requested resource
The requested resource was not found
Rate limit exceeded — retry after the period indicated in Retry-After header
Response Headers
Number of seconds to wait before retrying the request
Internal server error