Registrar Billeteras Cripto para Stablecoins

Una billetera (wallet) en SpherePay es un registro de la dirección de billetera blockchain existente de tu cliente. 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 cualquier transferencia on-ramp u off-ramp que involucre cripto.

SpherePay registra una dirección de billetera existente — no genera ni aloja una nueva billetera en nombre de tu cliente. La dirección debe existir ya en la red objetivo antes del registro.

Registrar una billetera

POST https://api.spherepay.co/v2/wallet Para el esquema completo de solicitud y respuesta, consulta la referencia API de Crear Billetera.

Redes soportadas

Red	Código de Red	USDC	USDT	EURC
Solana	`sol`	✅	—	✅
Ethereum	`ethereum`	✅	✅	✅
Tron	`tron`	—	✅	—
Polygon	`polygon`	✅	✅	—
Base	`base`	✅	—	✅
Arbitrum	`arbitrum`	✅	—	—
Avalanche	`avalanche`	✅	—	—
Starknet	`starknet`	✅	—	—

Solana no está soportada como red de destino para transferencias on-ramp BRL/PIX. Usa polygon, ethereum, base o tron cuando la divisa de origen sea BRL. Consulta Restricciones de transferencias BRL/PIX.

Ejemplo de solicitud

Pasa el ID de cliente, el código de red y la dirección on-chain para registrar la billetera.

{
  "customerId": "customer_1234567890",
  "network": "sol",
  "address": "0x1234567890123456789012345678901234567890"
}

Ejemplo de respuesta

{
  "id": "wallet_1234567890",
  "address": "0x1234567890123456789012345678901234567890",
  "network": "sol",
  "customerId": "customer_1234567890",
  "created": "2026-01-25T12:00:00.000Z",
  "updated": "2026-01-25T12:00:00.000Z"
}

Usar el ID devuelto

El id devuelto es tu referencia persistente a esta billetera. Guárdalo contra el registro del cliente y pásalo como source.id o destination.id al crear transferencias. No necesitas volver a registrar la misma dirección para transferencias posteriores — reutiliza el id almacenado.

​Registrar una billetera

​Redes soportadas

​Ejemplo de solicitud

​Ejemplo de respuesta

​Usar el ID devuelto

Registrar una billetera

Redes soportadas

Ejemplo de solicitud

Ejemplo de respuesta

Usar el ID devuelto