Skip to main content
POST
/
ramp
/
customer
/
{customer_id}
/
wallet
Register customer wallet
curl --request POST \
  --url https://api.etherfuse.com/ramp/customer/{customer_id}/wallet \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "blockchain": "solana",
  "claimOwnership": true,
  "publicKey": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
}
'
{
  "blockchain": "stellar",
  "claimedOwnership": true,
  "createdAt": "2026-05-01T14:30:00Z",
  "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "kycStatus": "approved",
  "publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
  "updatedAt": "2026-05-02T09:15:00Z",
  "walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}

Authorizations

​
Authorization
string
header
required

API key sent in the Authorization header.

Path Parameters

​
customer_id
string<uuid>
required

The customer (child org) ID. Must belong to the caller's organization or a direct child.

Body

application/json

Documented request body for registering a wallet — the bring-your-own (external) shape that is generally available today. Managed-wallet provisioning ({ "signer": … }) is not yet generally available and is intentionally omitted from the published schema. This type describes the wire shape for the docs; the handler deserializes the full [RegisterWalletPayload] enum.

​
blockchain
string
required

Target blockchain.

Example:

"solana"

​
publicKey
string
required

Wallet public key / address.

​
claimOwnership
boolean

Claim org ownership of the wallet for compliance attribution. Defaults to false.

Response

The registered wallet

​
blockchain
enum<string>
required

Blockchain the wallet is on.

Available options:
stellar,
solana,
base,
polygon,
monad
​
createdAt
string<date-time>
required

Timestamp when the wallet was created.

​
customerId
string<uuid>
required

ID of the customer who owns this wallet.

​
publicKey
string
required

Public key / address of the wallet.

​
updatedAt
string<date-time>
required

Timestamp when the wallet was last updated.

​
walletId
string<uuid>
required

Unique identifier for the wallet.

​
claimedOwnership
boolean | null

Whether the wallet has active claimed ownership by the organization. When true and the organization is approved, the wallet is treated as compliant without requiring individual KYC. Only present when claimed ownership has been set.

​
deletedAt
string<date-time> | null

Timestamp when the wallet was deleted (if applicable).

​
displayName
string | null

Display name for the wallet.

​
kycOnChain
boolean | null

Whether KYC is marked on-chain for the wallet. Only present for Solana wallets; for other blockchains this field is omitted as on-chain KYC marking does not apply.

​
kycStatus
string | null

Current KYC verification status for the wallet. Only present for individual wallet calls. The approved_chain_deploying status indicates the user is approved but waiting for on-chain marking (Solana only).