Create an account transfer
Create a transfer from an account to a verified blockchain address or another account.
Authorizations
Headers
Compact ES256 JWS that the Digital Asset Accounts SDK creates on the end user's device. It signs this request's method, path, and exact body bytes with the authorization key the end user registered. The SDK creates a new value for every call. To retry a request, resend the original body and header unchanged when you can. Operations where a retry with a new header returns 409 (error code 420034) explain in that response how to find the original request.
Required when the request acts on a non-custodial account (custodyType self), and not used for other accounts. A missing value on a non-custodial request returns 400 (error code 420031). A value that isn't a well-formed compact JWS returns 401 (error code 420031) on any account.
The SDK gives each value an expiry at most 5 minutes after it signs it. Circle rejects a value whose expiry has passed or whose signing time is in the future, allowing 60 seconds of clock difference either way, with 400 (error code 420031). A device clock that's off by more than 60 seconds causes the same error. Retry within the value's lifetime, or let the SDK sign the request again.
Your backend relay must forward this header, and the request body, exactly as the SDK sent them. Don't parse, reformat, or re-serialize the body. If the bytes change, Circle rejects the request.
Compact ES256 JWS created by the Digital Asset Accounts SDK on the end user's device.
64 - 8192"eyJhbGciOiJFUzI1NiJ9.e30.AAECAwQFBgcICQoLDA0ODxAREhMUFRYXGBkaGxwdHh8gISIjJCUmJygpKissLS4vMDEyMzQ1Njc4OTo7PD0-Pw"
Body
Risk metadata for the end user initiating the request. All three fields must be present.
deviceId must be the identifier returned by checkDevice() in the @circle-fin/device-checks SDK. Circle resolves it against the device check that produced it, so an identifier you generate yourself does not resolve. When it does not resolve, the request is accepted and then declined: the endpoint returns 201, and the transaction later settles as failed with errorCode transfer_denied. See Collect device risk signals.