Skip to main content
POST
Prepare a direct deposit authorization

Authorizations

Authorization
string
header
required

Cognito JWT token for regular user authentication

Body

sourceId
string
required

Opaque public funding source identifier

Example:

"fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X"

address
string
required

Destination wallet address to deposit into. Validated but not proven via wallet signature; authorization is derived from the verified ACH funding source.

Example:

"9n4nbM75f5Ui33ZbPYXn59EwSb9Y1zdyu3x2b1f8jQRY"

network
enum<string>
required
Available options:
solana,
ethereum,
polygon,
base,
avalanche,
arbitrum
asset
enum<string>
required

Asset sent to the deposit destination

Available options:
USDC
Example:

"USDC"

quoteType
enum<string>
required
Available options:
exact_input,
exact_output
amountUsd
string
required

Requested USD amount as a decimal string

Example:

"100.00"

priority
enum<string>
required
Available options:
normal,
high
feeSubsidy
object
clientContext
object

Response

Response for status 200

preparationId
string
required

Opaque public preparation identifier

Example:

"prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X"

kind
enum<string>
required
Available options:
deposit_authorization
expiresAt
string<date-time>
required
messageVersion
enum<string>
required
Available options:
v1
message
string
required

Display-ready ACH authorization message

summary
object
required