Skip to main content
POST
Create dedicated crypto wallet
Create a dedicated crypto collection wallet for a customer. The customer can reuse the wallet for future payments while it remains active. Calling this endpoint again with the same customerReference, asset, and environment returns the existing active assignment instead of creating a duplicate.

Endpoint

Headers

Request body

Example request

Successful response

Give the customer the value in address and clearly state the required asset and network.
A dedicated wallet may expire after one year without a confirmed payment. Retrieve its status before displaying a previously saved wallet to a customer.

Errors

Next step

List crypto dedicated wallets

Retrieve your customer address assignments.

Webhooks

Receive notifications when crypto payments arrive.

Authorizations

Authorization
string
header
required

Use an sk_test_... key in the playground. Never enter a live key in shared environments.

Body

application/json
customerReference
string
required
Example:

"CUSTOMER-1001"

asset
enum<string>
required
Available options:
USDC,
USDT
Example:

"USDC"

network
enum<string>
required
Available options:
SOLANA
Example:

"SOLANA"

metadata
object
Example:

Response

Dedicated crypto wallet created.

status
boolean
required
message
string
required
data
object
required