Pular para o conteúdo principal
Quando o Sphere direciona você aqui: A descoberta confirmou que a mesma entidade legal possui origem e destino — por exemplo, on-ramp de tesouraria, off-ramp de tesouraria ou financiamento/saque reutilizável para a própria conta bancária e carteira dessa entidade. Esta página define o padrão de implementação próprio (first-party) a construir. Para definições de objetos e payloads de API, siga os links para Conceitos e Referência da API.
Pagando funcionários, fornecedores, vendedores de marketplace ou outras terceiras partes? Use Fluxos de Terceiros.

​
Output de escopo

Ao final da descoberta, você e o SpherePay devem concordar em:
  • Tipo de cliente — pessoa física ou jurídica
  • Entidade legal que possui ambos origem e destino
  • Primeira movimentação — on-ramp, off-ramp ou ambos
  • Padrão — transferência avulsa, Onramper Account ou Offloader Wallet
  • Moeda fiat e rail
  • Stablecoin e rede
  • Transferências avulsas vs. instruções reutilizáveis
  • Apenas movimentação/conversão vs. manutenção de saldo fiat
  • Volume mensal esperado, tamanho médio e máximo de transação
  • Perfil de verificação e requisitos de habilitação de corredor
  • Campos de reconciliação que sua equipe financeira precisa

​
Escolha seu padrão

Transferência avulsa

Controle explícito de API por on-ramp ou off-ramp. Melhor quando cada movimentação é iniciada individualmente.

Onramper Account

Instruções reutilizáveis de depósito fiat que convertem automaticamente para stablecoin na carteira do cliente.

Offloader Wallet

Endereço de depósito de stablecoin reutilizável que converte automaticamente para fiat na conta bancária do cliente.

​
Como o fluxo funciona

Conta bancária do cliente ou conta de financiamento reutilizável → SpherePay → Carteira do cliente
Para um exemplo de round-trip de tesouraria, consulte Gestão de tesouraria.

​
Padrão: Transferência avulsa

Use quando: O cliente inicia cada on-ramp ou off-ramp individualmente e precisa de controle explícito por transferência. Sinais de descoberta:
  • Cada movimentação é iniciada em um ponto no tempo — não acionada por um endereço de depósito permanente
  • O integrador possui retry, idempotência e UX de status por transferência
  • O cliente pode precisar cotar ou executar transferências uma de cada vez
1

Criar ou recuperar o cliente

Registre a entidade legal via POST /v2/customer.
2

Completar KYC ou KYB

Conclua o KYC individual ou o KYB empresarial até que o perfil de verificação atinja approved.
3

Registrar instrumentos

Vincule a carteira e a conta bancária do cliente no mesmo registro de cliente.
4

Bloquear uma taxa (opcional)

Se o cliente precisar de uma taxa garantida, crie uma cotação com taxa bloqueada via POST /v2/quote (válida por 30, 60 ou 300 segundos, resgatável uma vez) e referencie seu quoteId ao criar a transferência.
5

Criar cada transferência

Chame POST /v2/transfer com cliente, origem e destino.
6

Rastrear e reconciliar

Consulte GET /v2/transfer/ até um status terminal — consulte Ciclo de vida da transferência.
Confirme que os instrumentos de origem e destino pertencem ao mesmo cliente cadastrado. Alguns corredores requerem habilitação específica do provedor além do KYC/KYB padrão — confirme o acesso com o SpherePay antes de construir.
Solução relacionada: Gestão de tesouraria

​
Padrão: Onramper Account

Use quando: O cliente precisa de instruções reutilizáveis de depósito fiat que convertem automaticamente para stablecoin em uma carteira de sua propriedade. Sinais de descoberta:
  • O cliente enviará fiat para as mesmas instruções de depósito repetidamente
  • Nenhuma chamada POST /v2/transfer deve ocorrer a cada depósito
  • O destino é uma carteira de stablecoin pertencente à mesma entidade legal
1

Criar ou recuperar o cliente

Registre a entidade legal via POST /v2/customer.
2

Completar KYC ou KYB

Atinja approved no perfil de verificação obrigatório.
3

Registrar a carteira de destino

O cliente já deve possuir o endereço on-chain. Registre via POST /v2/wallet.
4

Criar um Onramper Account

Chame POST /v2/virtual-account. Consulte Onramper Accounts.
5

Compartilhar instruções de depósito

Forneça depositInstructions da resposta. O SpherePay converte o fiat recebido e entrega a stablecoin automaticamente.
6

Rastrear depósitos e conversões

Consulte GET /v2/transfer filtrado por cliente (use type=microdeposit para depósitos de verificação) para listar transferências processadas pela conta. Cada depósito fiat aparece como uma transferência após detecção — reconcilie com seus depósitos esperados. Não há chamada de API por depósito para ancorar o status; defina sua cadência de polling e chaves de reconciliação antes do lançamento.
Onramper Accounts são um produto adicional. Crie uma conta por cliente — contas compartilhadas quebram a atribuição de depósito. Confirme se o produto está habilitado para seu rail e região.
Soluções relacionadas: Aceitação de pagamentos, Gestão de tesouraria

​
Padrão: Offloader Wallet

Use quando: O cliente precisa de um endereço on-chain reutilizável que converte automaticamente stablecoin recebida para fiat em uma conta bancária de sua propriedade. Sinais de descoberta:
  • O cliente enviará stablecoin para o mesmo endereço repetidamente
  • Nenhuma chamada POST /v2/transfer deve ocorrer a cada depósito
  • O destino fiat é uma conta bancária pertencente à mesma entidade legal
1

Criar ou recuperar o cliente

Registre a entidade legal via POST /v2/customer.
2

Completar KYC ou KYB

Atinja approved no perfil de verificação obrigatório.
3

Registrar a conta bancária de destino

Vincule a conta existente do cliente via POST /v2/bank-account.
4

Criar um Offloader Wallet

Chame POST /v2/offloader-wallet. Consulte Offloader Wallets.
5

Compartilhar o endereço do offloader

Forneça o endereço on-chain da resposta. O SpherePay converte a stablecoin e paga o fiat automaticamente.
6

Rastrear depósitos e pagamentos

Consulte GET /v2/transfer filtrado por cliente para rastrear depósitos de stablecoin e os pagamentos fiat resultantes até um status terminal — consulte o ciclo de vida da transferência.
Offloader Wallets são um produto adicional. Crie uma carteira por cliente. Para alterar moeda de origem/destino ou tipo de rail, crie uma nova carteira — outros campos podem ser atualizados via PATCH em Atualizar Offloader Wallet. Verifique o nome legal e o endereço físico do titular da conta bancária (sem caixas postais) antes de criar a carteira — parceiros rejeitam endereços com caixa postal, e os caminhos de correção para uma conta bancária vinculada são limitados.
Solução relacionada: Gestão de tesouraria

​
O que enviar ao Sphere antes do kickoff

  • Tipo de cliente: pessoa física ou jurídica
  • Entidade legal que possui origem e destino
  • Primeiro fluxo: on-ramp, off-ramp ou ambos
  • Padrão selecionado: transferência avulsa, Onramper Account ou Offloader Wallet
  • Moeda fiat e rail
  • Stablecoin e rede
  • Volume mensal esperado
  • Tamanho médio e máximo de transação
  • Instruções avulsas vs. reutilizáveis
  • Apenas movimentação/conversão vs. manutenção de saldo fiat
  • Requisitos de reconciliação

​
Validar antes de iniciar a engenharia

​
Lista de verificação pré-kickoff

  • A mesma entidade legal possui origem e destino
  • Padrão selecionado e confirmado com o SpherePay
  • Cliente criado ou recuperado; perfil de verificação approved para o corredor alvo
  • Provedor/corredor habilitado se necessário
  • Carteira e/ou conta bancária registradas no cliente correto
  • Rail, moeda e rede confirmados
  • Reconciliação e mapeamento de status definidos
  • Inputs de kickoff enviados ao SpherePay

​
Antes de entrar em produção

O SpherePay não possui sandbox separado — os testes de integração rodam em produção com dados de identidade reais. Execute uma transferência ao vivo de baixo valor em cada corredor antes do lançamento. A primeira transferência para um novo beneficiário pode acionar um RFI de conformidade do parceiro bancário. Defina essa expectativa com seu cliente desde o início e garanta que seu responsável de RFI designado esteja pronto para responder. Para dúvidas de liquidação de usuários finais, compartilhe os artigos da Base de Conhecimento do SpherePay When will the funds land in my account? e My funds are missing or have not landed in my account para que os usuários se autoatendam em vez de abrir tickets de suporte com você.

​
Aprofundar

Gestão de tesouraria

Resultado de tesouraria própria — exemplos de round-trip on-ramp/off-ramp.

Transferências

Ciclo de vida de transferência avulsa, restrições BRL/PIX e referência de status.

Fluxos de Terceiros

Quando origem e destino não são a mesma entidade legal.

Onboarding

Requisitos de KYC, KYB e perfil de verificação.

Base de Conhecimento e FAQ

Artigos de suporte para usuários finais — prazos de liquidação, fundos ausentes, mínimos e guias do painel — para repassar aos seus usuários.
Última modificação em 22 de junho de 2026