Skip to main content
Link your end customers’ bank accounts to their Digital Asset Accounts so they can move money between traditional banking and stablecoins. Wire deposits convert fiat into stablecoins. Wire withdrawals redeem stablecoin balances and send funds to the linked bank account. These steps apply to custodial and non-custodial accounts. Non-custodial accounts receive wire deposits through the same steps, and Circle converts a USD deposit to USDC, or a EUR deposit to EURC, and credits it to the account. Only the withdrawal in Step 5 differs, so choose the tab for your account type there.

Prerequisites

Before you begin, ensure that you’ve:
  • Obtained an API key for Digital Asset Accounts from Circle.
  • Onboarded an end customer with an active account and its accountId.
  • Reviewed whether Strong Customer Authentication (SCA) applies. Circle requires SCA headers on withdrawals and when linking wire accounts for end customers in the European Economic Area (EEA). See Implement SCA.
  • Run a device check for the end customer and kept the deviceId it returns. Every money movement and bank account request carries it in riskSignals. See Collect device risk signals.
  • For a non-custodial account, created the account and a DaaUserClient for the end customer, and set up your backend relay. See Create a non-custodial account.
  • Installed cURL on your development machine.

Steps

Link your end customer’s bank account by providing the bank details and billing information.
Response
For end customers in the European Economic Area (EEA), EUR funding uses the same wire flow. Provide the account’s iban instead of accountNumber and routingNumber. EUR deposits mint EURC.
To retrieve EUR-denominated instructions, pass currency=EUR when you get wire instructions in the next step.

Step 2. Get wire instructions

Retrieve the wire instructions for the linked bank account. Share these with your end customer so they can send a wire deposit from their bank.
Response
The trackingRef is a unique reference code that identifies the wire deposit. Your customer must include it in their wire transfer so Circle can match the payment to the correct account.
Your end customer must include the trackingRef when sending the wire transfer. Without this reference, the deposit cannot be matched to the correct account.

Step 3. Deposit fiat (sandbox simulation)

In the sandbox environment, simulate a wire deposit using the mock payments endpoint. In production, your end customer sends a real wire transfer using the instructions from the previous step.
Response

Step 4. Check the balance

Confirm that the deposit has been credited to the account.
Response

Step 5. Withdraw to a bank account

To withdraw stablecoins as fiat, create a withdrawal that specifies the amount, the destination wire account, and the source account.
Response
The withdrawal processes asynchronously. Monitor the status by polling the withdrawals endpoint or by setting up webhook notifications.If the source account has insufficient funds, the API returns an error:
Verify the account balance before initiating a withdrawal.

List and retrieve wire accounts

You can query linked wire accounts at any time. List all wire accounts for an end customer
Get a specific wire account