Saltar al contenido principal
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

RedCódigo de RedUSDCUSDTEURC
Solanasol✅—✅
Ethereumethereum✅✅✅
Trontron—✅—
Polygonpolygon✅✅—
Basebase✅—✅
Arbitrumarbitrum✅——
Avalancheavalanche✅——
Starknetstarknet✅——
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.
Última modificación el 18 de junio de 2026