Saltar al contenido principal
Create a Wallet
curl --request POST \
  --url https://api.spherepay.co/v2/wallet \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "customer_66c4168d418a410eae282b83883bdc39",
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "network": "sol"
}
'
{
  "id": "wallet_ce745ef7f3df4b9a8bff1301ce24b045",
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "network": "sol",
  "customerId": "customer_66c4168d418a410eae282b83883bdc39",
  "created": "2025-01-01T00:00:00.000Z",
  "updated": "2025-01-01T00:00:00.000Z"
}
Usa este endpoint para registrar la dirección de billetera blockchain existente de un cliente en SpherePay. SpherePay no crea ni custodia billeteras — vincula una dirección que tu cliente ya posee a su perfil de SpherePay para que las transferencias puedan enrutarse hacia o desde esa dirección. Debes registrar al menos una billetera antes de crear una transferencia que involucre cripto. La dirección de la billetera ya debe existir en la red objetivo antes del registro.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cuerpo

application/json
customerId
string
requerido

The unique identifier of the customer who owns this wallet.

Minimum string length: 1
Ejemplo:

"customer_66c4168d418a410eae282b83883bdc39"

address
string
requerido

The wallet address on the specified network. Must be a valid address format for the network.

Minimum string length: 1
Ejemplo:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

network
enum<string>
requerido

The blockchain network for this wallet. Must be a supported crypto network.

Opciones disponibles:
arbitrum,
avalanche,
base,
ethereum,
optimism,
polygon,
sol,
tron
Ejemplo:

"sol"

Respuesta

id
string
requerido

The unique identifier of the wallet.

Ejemplo:

"wallet_ce745ef7f3df4b9a8bff1301ce24b045"

address
string
requerido

The wallet address on the specified network.

Ejemplo:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

network
enum<string>
requerido

The blockchain network for this wallet.

Opciones disponibles:
sol,
fogo,
ethereum,
optimism,
arbitrum,
polygon,
base,
avalanche,
sui,
noble,
sei,
tron,
starknet,
aptos,
hyperliquid
Ejemplo:

"sol"

customerId
string
requerido

The unique identifier of the customer who owns this wallet.

Ejemplo:

"customer_66c4168d418a410eae282b83883bdc39"

created
string
requerido

The ISO 8601 timestamp when the wallet was created.

Ejemplo:

"2025-01-01T00:00:00.000Z"

updated
string
requerido

The ISO 8601 timestamp when the wallet was last updated.

Ejemplo:

"2025-01-01T00:00:00.000Z"

Última modificación el 18 de junio de 2026