Add Bank Account to Recipient

Add a new bank account to an existing recipient.

⚠️ Important: Accurate Account Holder Information Required

• The account_holder_name must exactly match the name registered with the bank
• Ensure all bank account details (account number, routing number, SWIFT code, etc.) are accurate
• Incorrect or mismatched information may result in failed, delayed, or returned transfers
• The bank may reject transfers if the beneficiary name does not match their records

Functionality:

• Registers a bank account that can be used for fiat withdrawals to this recipient
• Supports US Fedwire, US ACH, and SWIFT international wires
• Automatically assigns a unique bank_account_id upon successful creation

Status:

• Bank account is created with PENDING status
• Status changes to APPROVED after vendor approval (async process)
• Status changes to FAILED if vendor rejects the account
• Subscribe to external_account.approved and external_account.failed webhooks for status updates

Idempotency & Duplicate Detection:

• Required: Include an Idempotency-Key header with a unique UUID