Novo no SpherePay? Comece com Como funciona e Conceitos. Você sabe seu resultado de negócio mas não o tipo de fluxo? Leia esta página primeiro, depois Soluções.
Como usar esta seção
Confirmar inputs de escopo
Trabalhe os Antes de escolher um guia com seu representante SpherePay — partes, rails, volume e modelo de transferência.
Direcionar-se a um guia e padrão
Use Direcionar pelo resultado da descoberta para escolher Fluxos Próprios (First-Party) ou Fluxos de Terceiros (Third-Party) e o padrão dentro desse guia.
Validar antes da engenharia
Complete o output de escopo do guia, a lista de kickoff e as verificações de bloqueadores antes de escrever código de integração.
Aprofundar onde necessário
Siga links para Conceitos, Soluções e Referência da API para definições de objetos, exemplos de negócio e payloads.
Para que servem estes guias
| Seção | Use para… |
|---|---|
| Guias de Implementação (esta seção) | Direcionar para um caminho de construção, validar o escopo e saber o que enviar ao Sphere antes do kickoff |
| Conceitos | Aprender o que cada objeto significa — clientes, transferências, automação, rails |
| Soluções | Ver como os primitivos se combinam para um resultado de negócio — tesouraria, folha de pagamento, trading |
| Referência da API | Implementar detalhes de requisição/resposta para um endpoint específico |
Antes de escolher um guia
Confirme estes inputs com seu representante SpherePay durante ou imediatamente após a descoberta:- Quem possui os fundos em cada etapa
- Cliente de registro — quem o SpherePay deve cadastrar e verificar
- Remetente e beneficiário — podem diferir do cliente de registro
- Função da plataforma — se sua plataforma está no fluxo de fundos
- Usuários downstream — empresas, consumidores ou ambos
- Moeda fiat e rail — consulte Rails suportados
- Stablecoin e rede — consulte Ativos suportados
- Modelo de transferência — transferências API avulsas vs. instruções reutilizáveis de depósito/saque
- Modelo de saldo — apenas movimentação/conversão vs. manutenção de saldo fiat
- Volume — volume mensal esperado, tamanho médio e máximo de transação
Direcionar pelo resultado da descoberta
| Após a descoberta, você sabe… | Comece aqui | Padrão |
|---|---|---|
| A mesma entidade legal possui origem e destino | Fluxos Próprios | — |
| Cada on-ramp/off-ramp é iniciado explicitamente via API | Fluxos Próprios | Transferência avulsa |
| Instruções reutilizáveis de depósito fiat para a própria carteira do cliente | Fluxos Próprios | Onramper Account |
| Saque reutilizável de stablecoin para fiat para a própria conta bancária do cliente | Fluxos Próprios | Offloader Wallet |
| Uma empresa paga um fornecedor, vendedor, prestador de serviços ou outra terceira parte | Fluxos de Terceiros | Empresa paga fornecedor |
| Uma plataforma permite que seus clientes empresariais movam fundos | Fluxos de Terceiros | Plataforma atende clientes empresariais |
| Um banco ou fintech incorpora ramps para muitos usuários finais | Fluxos de Terceiros | Banco ou fintech atende consumidores |
Escolha um guia
Fluxos Próprios (First-Party)
A mesma entidade legal possui origem e destino — transferências avulsas, Onramper Accounts e Offloader Wallets.
Fluxos de Terceiros (Third-Party)
Partes diferentes ou fluxos mediados por plataforma — pagamentos a fornecedores, B2B de plataforma e caminhos de incorporação para consumidores.
Próprio (first-party) ou de terceiros (third-party)?
Se a tabela de roteamento acima não corresponder claramente, use esta bifurcação:| Tipo de fluxo | Direcionar quando | Exemplo |
|---|---|---|
| Próprio (first-party) | A mesma entidade legal possui origem e destino | Conta bancária da empresa → carteira da mesma empresa |
| De terceiros (third-party) | Remetente, beneficiário ou cliente de registro são entidades diferentes, ou uma plataforma atende usuários downstream | Carteira da empresa → conta bancária do fornecedor |
Mapear para Soluções
Guias de Implementação definem como construir. Soluções definem qual resultado de negócio você está entregando. Use ambos:Gestão de tesouraria
On-ramp/off-ramp de tesouraria própria — combine com Fluxos Próprios.
Aceitação de pagamentos
Aceitação de fiat pela plataforma — frequentemente Fluxos de Terceiros ou padrão Onramper.
Folha de pagamento
Desembolsos de terceiros — combine com Fluxos de Terceiros.
Financiamento de comércio internacional
Liquidação de fornecedores e faturas — combine com Fluxos de Terceiros.