Skip to main content
POST
Create a wallet
Two types of wallet. A standard wallet keeps its balance until you withdraw it (paid plans). A collect wallet (USDC on Solana or Base, every plan, Découverte included) forwards its whole balance to your destination_address as soon as it reaches $3, with no deposit fee. See Collect wallets.
Collect wallet
Check that destination_address is an address on the blockchain of the wallet. Forwards are blockchain transfers: they cannot be cancelled or reversed.

Authorizations

Authorization
string
header
required

API key (sk_test_... or sk_live_...)

Body

application/json
customer_code
string<uuid>
required

Code of the customer who owns the wallet

blockchain
enum<string>
required
Available options:
solana,
base,
ethereum,
tron
Example:

"solana"

currency
enum<string>

Optional. Defaults to the currency of the blockchain (USDC, or USDT on tron).

Available options:
USDC,
USDT
Example:

"USDC"

reference
string

Optional. Your own label for this address: an order number, an invoice number, a session id... Each new reference opens an additional address for the customer on this blockchain (the creation fee applies). The same reference returns the same wallet, at no cost. Letters, digits and . _ : -.

Maximum string length: 64
Example:

"order-1001"

type
enum<string>
default:standard

Optional. standard (default) or collect. A collect wallet forwards its balance automatically to destination_address and is only available for USDC on solana and base.

Available options:
standard,
collect
Example:

"collect"

destination_address
string

Required for a collect wallet, refused for a standard wallet. The address that receives the forwards, on the same blockchain as the wallet. It cannot be the address of a KemyCard collect wallet. You can change it later with PATCH /wallets/{code}/destination.

Example:

"YOUR_SOLANA_ADDRESS"

Response

The customer already has a wallet of this type on this blockchain (with the same reference, and for a collect wallet the same destination_address). It is returned as is, nothing is charged.

success
boolean
Example:

true

data
object
meta
object