Withdrawal Status Changed

Creates a withdrawal to the customer's registered bank account. **Prerequisites** API withdrawals must be enabled for your organization. If not enabled, this endpoint returns `403 Forbidden`. Contact support to enable API withdrawals. This endpoint requires an API key. Browser-session withdrawals must use the dashboard approval flow. **Execution Modes** 1. **Automatic Execution** (`PROCESSING`) — Withdrawal executes immediately when: - Sufficient available allowance - Sufficient USDC balance in wallet 2. **Manual Approval** (`PROPOSED`) — Transaction created for dashboard approval when: - Withdrawal exceeds available allowance - Insufficient USDC balance in wallet (user can deposit funds before signing) - Automatic execution fails (transaction converted to manual approval) `PROPOSED` is only used when the on-chain allowance module is configured. If API withdrawals are enabled but the module or delegate is not configured on your Safe, or the allowance cannot be read, the request fails with `500` `{"error": "Failed to execute withdrawal"}`. If your organization has no Safe wallet, wallet USDC withdrawals fail with `404` (custodial withdrawals do not need a Safe). `GET /customers/withdrawal/allowance` returns `enabled: false` in these cases. **Custodial Balances** USDT and EURC (and USDC when `source` is `custodial`) are held on the customer's custodial balance rather than the wallet. These withdrawals are debited and paid out immediately (`PROCESSING`) when the organization has custodial balances and API withdrawals enabled. There is no manual-approval fallback: an insufficient custodial balance returns `400`, and a disabled feature returns `403`. **AUD Withdrawals** AUD-only customers withdraw to their AUD withdrawal banks (`paymentRail: "AU_BANK_TRANSFER"`) from the wallet or a custodial balance when AUD functionality is enabled for your organization; the customer does not need to be KYC verified, and the account must be active. The withdrawal stays `PROCESSING` until the bank payment settles. A withdrawal that reached `COMPLETED` can later move to `FAILED` if the receiving bank returns the payment; a `withdrawal.status_changed` webhook is sent. Standard customers cannot withdraw to AUD withdrawal banks, and AUD-only customers still get `400` for EUR and USD accounts. AUD withdrawals are funded with USDC or USDT only: EURC returns `400`, as does an AUD withdrawal bank when AUD functionality is not enabled for your organization. **Amount Specification** Specify the withdrawal amount using one of: - `sourceAmount`: Amount in the source currency to withdraw - `targetAmount`: Amount to receive in the bank's currency The target currency is automatically determined by the withdrawal bank's configured currency. **Idempotency** Use the `idempotencyKey` to safely retry requests. Duplicate requests with the same key return the original transaction without creating a new one. Reusing a key for a different customer returns `409`.