> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Registrar Billeteras Cripto para Stablecoins

> Vincula la dirección de billetera blockchain de un cliente a SpherePay para habilitar transferencias on-ramp y off-ramp en 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.

<Note>
  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.
</Note>

## 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](/es/api-reference/wallet/post).

## 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`    | ✅    | —    | —    |

<Note>
  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](/es/concepts/transfers/overview#brlpix-transfer-constraints).
</Note>

## Ejemplo de solicitud

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

```json theme={"dark"}
{
  "customerId": "customer_1234567890",
  "network": "sol",
  "address": "0x1234567890123456789012345678901234567890"
}
```

## Ejemplo de respuesta

```json theme={"dark"}
{
  "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.
