Prerequisites
Before you begin, ensure that you’ve:- Obtained an API key for Digital Asset Accounts from Circle.
- Onboarded the end customer and funded their account.
- Registered the destination as a recipient address, and waited until its
statusisactiveorverification_succeeded. See Manage recipient addresses. - Run a device check for the end customer and kept the
deviceIdit returns. Every transfer carries it inriskSignals. See Collect device risk signals. - Installed cURL on your development machine.
- For end customers in the European Economic Area (EEA), prepared a Strong Customer Authentication (SCA) assertion. Transfers are SCA-gated. See Implement SCA.
- For a non-custodial account, created the account and a
DaaUserClientfor the end customer, and set up your backend relay. See Create a non-custodial account.
Steps
Step 1. Create a transfer
- Custodial account
- Non-custodial account
Initiate a transfer to the registered recipient address. Specify the source
account as an ResponseFor end customers in the EEA, add the
account type and the destination as a verified_blockchain
type. The verified_blockchain type indicates a pre-registered external
blockchain address. Set destination.addressId to the id of a recipient
address whose status is active or verification_succeeded.X-Sca-Challenge-Id and X-Sca-Assertion
headers. If the source account has insufficient funds, the API returns an error.
Check the account balance before creating a transfer.Step 2. Check the transfer status
Monitor the transfer until it reaches a terminal state. Transfers move throughpending, complete, and failed states. See
Transaction states for
details. Instead of polling, you can subscribe to
webhook notifications for
transfer status changes.
- Custodial account
- Non-custodial account