> ## 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 Carteiras Cripto para Stablecoins

> Vincule o endereço de carteira blockchain de um cliente ao SpherePay para habilitar transferências de on-ramp e off-ramp em stablecoins.

Uma carteira (`wallet`) no SpherePay é o registro do endereço de carteira blockchain existente do seu cliente. O SpherePay não cria nem custodia carteiras — ele vincula um endereço que seu cliente já possui ao perfil SpherePay dele para que as transferências possam ser roteadas para ou a partir desse endereço. Você deve registrar pelo menos uma carteira antes de criar qualquer transferência de on-ramp ou off-ramp que envolva cripto.

<Note>
  O SpherePay registra um endereço de carteira existente — não gera nem hospeda uma nova carteira em nome do seu cliente. O endereço já deve existir na rede alvo antes do registro.
</Note>

## Registrar uma carteira

`POST https://api.spherepay.co/v2/wallet`

Para o esquema completo de requisição e resposta, consulte a [referência da API de Criar Carteira](/pt-BR/api-reference/wallet/post).

## Redes suportadas

| Rede      | Código da rede | USDC | USDT | EURC |
| --------- | -------------- | ---- | ---- | ---- |
| Solana    | `sol`          | ✅    | —    | ✅    |
| Ethereum  | `ethereum`     | ✅    | ✅    | ✅    |
| Tron      | `tron`         | —    | ✅    | —    |
| Polygon   | `polygon`      | ✅    | ✅    | —    |
| Base      | `base`         | ✅    | —    | ✅    |
| Arbitrum  | `arbitrum`     | ✅    | —    | —    |
| Avalanche | `avalanche`    | ✅    | —    | —    |
| Starknet  | `starknet`     | ✅    | —    | —    |

<Note>
  Solana não é suportada como rede de destino para transferências de on-ramp em BRL/PIX. Use `polygon`, `ethereum`, `base` ou `tron` quando a moeda de origem for BRL. Consulte [Restrições de transferências BRL/PIX](/pt-BR/concepts/transfers/overview#restrições-de-transferências-brlpix).
</Note>

## Exemplo de requisição

Passe o ID do cliente, o código da rede e o endereço on-chain para registrar a carteira.

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

## Exemplo de resposta

```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"
}
```

## Usando o ID retornado

O `id` retornado é sua referência persistente a esta carteira. Armazene-o contra o registro do cliente e passe-o como `source.id` ou `destination.id` ao criar transferências. Você não precisa registrar novamente o mesmo endereço para transferências subsequentes — reutilize o `id` armazenado.