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.
| Padrão | Sinais de descoberta | Objetos primários |
|---|---|---|
| Transferência avulsa | Controle de API por movimentação; conversões avulsas; rastreamento de status por transferência | Cliente, carteira, conta bancária, transferência |
| Onramper Account | Depósitos fiat reutilizáveis; conversão automática para stablecoin; sem chamada de transferência por depósito | Cliente, carteira, Onramper Account |
| Offloader Wallet | Depósitos de stablecoin reutilizáveis; conversão automática para fiat; sem chamada de transferência por depósito | Cliente, conta bancária, Offloader Wallet |
Como o fluxo funciona
- On-ramp
- Off-ramp
Conta bancária do cliente ou conta de financiamento reutilizável → SpherePay → Carteira do cliente
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
Criar ou recuperar o cliente
Registre a entidade legal via POST /v2/customer.
Completar KYC ou KYB
Conclua o KYC individual ou o KYB empresarial até que o perfil de verificação atinja
approved.Registrar instrumentos
Vincule a carteira e a conta bancária do cliente no mesmo registro de cliente.
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.Criar cada transferência
Chame POST /v2/transfer com cliente, origem e destino.
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.
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/transferdeve ocorrer a cada depósito - O destino é uma carteira de stablecoin pertencente à mesma entidade legal
Criar ou recuperar o cliente
Registre a entidade legal via POST /v2/customer.
Registrar a carteira de destino
O cliente já deve possuir o endereço on-chain. Registre via POST /v2/wallet.
Criar um Onramper Account
Chame POST /v2/virtual-account. Consulte Onramper Accounts.
Compartilhar instruções de depósito
Forneça
depositInstructions da resposta. O SpherePay converte o fiat recebido e entrega a stablecoin automaticamente.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.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/transferdeve ocorrer a cada depósito - O destino fiat é uma conta bancária pertencente à mesma entidade legal
Criar ou recuperar o cliente
Registre a entidade legal via POST /v2/customer.
Registrar a conta bancária de destino
Vincule a conta existente do cliente via POST /v2/bank-account.
Criar um Offloader Wallet
Chame POST /v2/offloader-wallet. Consulte Offloader Wallets.
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.
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.
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
| Bloqueador | O que normalmente significa |
|---|---|
| Perfil de verificação não aprovado | O perfil de KYC/KYB obrigatório está incompleto, pendente, ausente ou rejeitado |
| Provedor/corredor não habilitado | O cliente pode estar aprovado em geral, mas não habilitado para o corredor ou rail específico |
| Rail, moeda ou rede não suportados | Combinação não disponível para seu produto — Rails suportados |
| Incompatibilidade de propriedade | O instrumento de origem ou destino não pertence ao cliente cadastrado |
| Confusão com carteira | POST /v2/wallet registra um endereço existente — o SpherePay não gera nem custodia chaves privadas |
| Confusão com Onramper Account | Automatiza conversão de fiat para stablecoin via instruções de depósito — confirme requisitos de apenas movimentação vs. manutenção de saldo |
| Atualizações de Offloader Wallet | Alterar moeda de origem/destino ou tipo de rail requer uma nova carteira; outros campos podem ser atualizados via PATCH |
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
approvedpara 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.