Create a Crypto Deposit Address

POST / v1 / crypto / deposit_addresses

Creates a new crypto deposit address for the authenticated merchant on the specified network. The returned address can be used across multiple PaymentIntents.

Parameters

• network enum Required The blockchain network to generate a deposit address for. Possible enum values base Base network. solana Solana network. tempo Tempo network.
• metadata map Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

More parameters

• customer string

Returns

Returns a crypto.deposit_address object

cURL

Response

{ "id": "cda_1MzUx82eZvKYlo2CB6XoRDA6", "object": "crypto.deposit_address", "livemode": false, "created": 1719947634, "network": "tempo", "address": "0x5ff8d73e8bccd3701c9aef78389f3b9771172b5c", "supported_tokens": [ { "token_currency": "usdc", "token_contract_address": "0x20c0000000000000000000009e8d7eb59b783726" } ], "metadata": {}}

Retrieve a Crypto Deposit Address

GET / v1 / crypto / deposit_addresses /:id

Retrieves the details of an existing crypto deposit address by ID.

Parameters

No parameters.

Returns

Returns a crypto.deposit_address object

cURL

Response

{ "id": "cda_1MzUx82eZvKYlo2CB6XoRDA6", "object": "crypto.deposit_address", "livemode": false, "created": 1719947634, "network": "tempo", "address": "0x5ff8d73e8bccd3701c9aef78389f3b9771172b5c", "supported_tokens": [ { "token_currency": "usdc", "token_contract_address": "0x20c0000000000000000000009e8d7eb59b783726" } ], "metadata": {}}

List Crypto Deposit Addresses

GET / v1 / crypto / deposit_addresses

Lists crypto deposit addresses for the authenticated merchant. Supports cursor-based pagination and optional filtering by customer, network, or on-chain address.

Parameters

• address string Only return the deposit address matching this on-chain address.
• customer string Only return deposit addresses scoped to this Customer.
• customer _ account string Only return deposit addresses belonging to this customer account.
• network enum Only return deposit addresses for this blockchain network. Possible enum values base Base network. solana Solana network. tempo Tempo network.

More parameters

• ending _ before string
• limit integer
• starting _ after string

Returns

Returns a list of crypto.deposit_address objects

cURL

Response