> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Guias de Implementação
> Roteamento pós-descoberta para integrações SpherePay — escolha o caminho de implementação, padrão e documentação a usar após o fluxo de fundos ser definido.
Use os Guias de Implementação **após a descoberta**, quando o Sphere e sua equipe já entenderem o fluxo de fundos pretendido, as partes, os rails e o modelo operacional. Estas páginas transformam essa conversa em um **caminho de construção definido** para o seu integrador — não uma visão geral de produto.
Novo no SpherePay? Comece com [Como funciona](/pt-BR/get-started/how-it-works) e [Conceitos](/pt-BR/concepts/overview). Você sabe seu resultado de negócio mas não o tipo de fluxo? Leia esta página primeiro, depois [Soluções](/pt-BR/solutions/overview).
## Como usar esta seção
Trabalhe os [Antes de escolher um guia](#antes-de-escolher-um-guia) com seu representante SpherePay — partes, rails, volume e modelo de transferência.
Use [Direcionar pelo resultado da descoberta](#direcionar-pelo-resultado-da-descoberta) para escolher [Fluxos Próprios (First-Party)](/pt-BR/implementation-guides/first-party-flows) ou [Fluxos de Terceiros (Third-Party)](/pt-BR/implementation-guides/third-party-flows) e o padrão dentro desse guia.
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.
Siga links para [Conceitos](/pt-BR/concepts/overview), [Soluções](/pt-BR/solutions/overview) e [Referência da API](/pt-BR/api-reference/customer/post) 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](/pt-BR/concepts/overview) | Aprender o que cada objeto significa — clientes, transferências, automação, rails |
| [Soluções](/pt-BR/solutions/overview) | Ver como os primitivos se combinam para um resultado de negócio — tesouraria, folha de pagamento, trading |
| [Referência da API](/pt-BR/api-reference/customer/post) | 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](/pt-BR/concepts/transfers/supported-rails)
* **Stablecoin e rede** — consulte [Ativos suportados](/pt-BR/concepts/reference/supported-assets)
* **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](/pt-BR/implementation-guides/first-party-flows) | — |
| Cada on-ramp/off-ramp é iniciado explicitamente via API | [Fluxos Próprios](/pt-BR/implementation-guides/first-party-flows) | [Transferência avulsa](/pt-BR/implementation-guides/first-party-flows#padrão-transferência-avulsa) |
| Instruções reutilizáveis de depósito fiat para a própria carteira do cliente | [Fluxos Próprios](/pt-BR/implementation-guides/first-party-flows) | [Onramper Account](/pt-BR/implementation-guides/first-party-flows#padrão-onramper-account) |
| Saque reutilizável de stablecoin para fiat para a própria conta bancária do cliente | [Fluxos Próprios](/pt-BR/implementation-guides/first-party-flows) | [Offloader Wallet](/pt-BR/implementation-guides/first-party-flows#padrão-offloader-wallet) |
| Uma empresa paga um fornecedor, vendedor, prestador de serviços ou outra terceira parte | [Fluxos de Terceiros](/pt-BR/implementation-guides/third-party-flows) | [Empresa paga fornecedor](/pt-BR/implementation-guides/third-party-flows#padrão-empresa-paga-fornecedor) |
| Uma plataforma permite que seus clientes empresariais movam fundos | [Fluxos de Terceiros](/pt-BR/implementation-guides/third-party-flows) | [Plataforma atende clientes empresariais](/pt-BR/implementation-guides/third-party-flows#padrão-plataforma-atende-clientes-empresariais) |
| Um banco ou fintech incorpora ramps para muitos usuários finais | [Fluxos de Terceiros](/pt-BR/implementation-guides/third-party-flows) | [Banco ou fintech atende consumidores](/pt-BR/implementation-guides/third-party-flows#padrão-banco-ou-fintech-atende-consumidores) |
## Escolha um guia
A mesma entidade legal possui origem e destino — transferências avulsas, Onramper Accounts e Offloader Wallets.
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 |
Ainda indeciso? Pergunte: **A mesma entidade legal possui origem e destino?** Se sim → próprio (first-party). Se não → de terceiros (third-party).
## Mapear para Soluções
Guias de Implementação definem **como construir**. Soluções definem **qual resultado de negócio** você está entregando. Use ambos:
On-ramp/off-ramp de tesouraria própria — combine com [Fluxos Próprios](/pt-BR/implementation-guides/first-party-flows).
Aceitação de fiat pela plataforma — frequentemente [Fluxos de Terceiros](/pt-BR/implementation-guides/third-party-flows) ou padrão Onramper.
Desembolsos de terceiros — combine com [Fluxos de Terceiros](/pt-BR/implementation-guides/third-party-flows).
Liquidação de fornecedores e faturas — combine com [Fluxos de Terceiros](/pt-BR/implementation-guides/third-party-flows).