Pular para o conteúdo principal
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.
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.

​
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.

​
Redes suportadas

RedeCódigo da redeUSDCUSDTEURC
Solanasol✅—✅
Ethereumethereum✅✅✅
Trontron—✅—
Polygonpolygon✅✅—
Basebase✅—✅
Arbitrumarbitrum✅——
Avalancheavalanche✅——
Starknetstarknet✅——
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.

​
Exemplo de requisição

Passe o ID do cliente, o código da rede e o endereço on-chain para registrar a carteira. 
{
  "customerId": "customer_1234567890",
  "network": "sol",
  "address": "0x1234567890123456789012345678901234567890"
}

​
Exemplo de resposta

{
  "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.
Última modificação em 18 de junho de 2026