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
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.Exemplo de resposta
Usando o ID retornado
Oid 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.