# SpherePay: Brazilian Portuguese ## Brazilian Portuguese ### Começar #### Introdução - [SpherePay: Pagamentos com stablecoin para empresas globais](https://docs.spherepay.co/pt-BR/introduction.md): O SpherePay é uma plataforma API-first para on-ramp e off-ramp entre USD, EUR, BRL e USDC, USDT, EURC com conformidade KYC/KYB integrada. #### Começar - [Como o SpherePay Funciona: Visão Geral da Integração](https://docs.spherepay.co/pt-BR/get-started/how-it-works.md): Aprenda o modelo de integração em três etapas do SpherePay: crie um cliente verificado, registre um instrumento de transferência e execute uma transferência. - [Autenticar com a API do SpherePay](https://docs.spherepay.co/pt-BR/get-started/authentication.md): Todas as requisições à API do SpherePay usam autenticação por Bearer token. Saiba como gerar sua chave de API e passá-la corretamente em cada requisição. - [Faça Sua Primeira Chamada à API do SpherePay](https://docs.spherepay.co/pt-BR/get-started/first-api-call.md): Passo a passo para criar um cliente, registrar uma conta bancária e carteira, e executar sua primeira transferência de on-ramp com a API do SpherePay. - [Download da Especificação OpenAPI 3.0 do SpherePay](https://docs.spherepay.co/pt-BR/get-started/openapi-spec.md): Baixe a especificação OpenAPI 3.0 do SpherePay para gerar clientes de API, importar no Postman ou Insomnia, ou criar ferramentas e integrações personalizadas. ### Conceitos - [Conceitos e Dados de Referência do SpherePay](https://docs.spherepay.co/pt-BR/concepts/overview.md): Modelos mentais centrais e dados de referência para construir no SpherePay — onboarding, transferências, automação, rails suportados e detalhes operacionais. #### Onboarding - [Clientes e Onboarding no SpherePay](https://docs.spherepay.co/pt-BR/concepts/onboarding/overview.md): Crie e verifique clientes antes de qualquer transferência. Conheça o KYC para pessoas físicas e o KYB para empresas na API do SpherePay. - [KYC para Clientes Pessoas Físicas](https://docs.spherepay.co/pt-BR/concepts/onboarding/individual-kyc.md): Cadastre clientes pessoas físicas com verificação de identidade KYC. Escolha entre API ou link hospedado, com conformidade Sphere-Managed ou Platform-Managed. - [KYB para Clientes Empresariais](https://docs.spherepay.co/pt-BR/concepts/onboarding/business-kyb.md): Cadastre clientes empresariais com verificação KYB. Envie documentos, registre UBOs e conclua a verificação via API ou link hospedado. - [Cadastre Clientes com um Link de KYC Hospedado](https://docs.spherepay.co/pt-BR/concepts/onboarding/kyc-via-link.md): Use o link de onboarding hospedado do SpherePay para verificar clientes sem construir uma UI personalizada. Conclua KYC ou KYB em poucos minutos. - [Perfil de Verificação e Status do Cliente](https://docs.spherepay.co/pt-BR/concepts/onboarding/verification-profile.md): O perfil de verificação rastreia o estado de aprovação KYC ou KYB de um cliente. Saiba o que cada status significa e o que desencadeia transições entre estados. - [Tipos de ID e CPF/CNPJ aceitos](https://docs.spherepay.co/pt-BR/concepts/onboarding/identification-types.md): Referência dos documentos de identidade e números de identificação fiscal por país aceitos para onboarding de clientes pessoa física e jurídica. #### Transferências - [API de Transferências: Guia de On-Ramp e Off-Ramp](https://docs.spherepay.co/pt-BR/concepts/transfers/overview.md): Crie transferências de on-ramp e off-ramp com a API do SpherePay: fluxo de integração, exemplos em USD e BRL/PIX e acompanhamento de status. - [Ciclo de Vida e Referência de Status de Transferência](https://docs.spherepay.co/pt-BR/concepts/transfers/lifecycle.md): Entenda como as transferências do SpherePay avançam por cada status — de pendingFunding até succeeded, returned ou failed — e como tratar cada estado. - [Registrar Contas Bancárias para Transferências Fiat](https://docs.spherepay.co/pt-BR/concepts/transfers/bank-accounts.md): Vincule a conta bancária fiat de um cliente ao SpherePay para habilitar transferências de on-ramp e off-ramp via ACH, Wire, SEPA ou PIX. - [Registrar Carteiras Cripto para Stablecoins](https://docs.spherepay.co/pt-BR/concepts/transfers/wallets.md): Vincule o endereço de carteira blockchain de um cliente ao SpherePay para habilitar transferências de on-ramp e off-ramp em stablecoins. - [Rails de Pagamento e Stablecoins Suportados](https://docs.spherepay.co/pt-BR/concepts/transfers/supported-rails.md): Veja todos os rails de origem e destino, moedas e redes de stablecoin suportados para Transferências, Onramper Accounts e Offloader Wallets do SpherePay. #### Automação - [Onramper Accounts: Fiat para Stablecoin Automatizado](https://docs.spherepay.co/pt-BR/concepts/automation/onramper-accounts.md): Onramper Accounts dão a cada cliente uma conta bancária virtual dedicada que converte automaticamente depósitos fiat em stablecoins on-chain. - [Offloader Wallets: Cripto para Fiat Automatizado](https://docs.spherepay.co/pt-BR/concepts/automation/offloader-wallets.md): Offloader Wallets dão a cada cliente um endereço on-chain dedicado que converte automaticamente stablecoins recebidas em pagamentos fiat para conta bancária. #### Webhooks - [Visão Geral de Webhooks](https://docs.spherepay.co/pt-BR/concepts/webhooks/overview.md): Receba notificações em tempo real quando clientes, transferências e outros recursos do SpherePay mudarem de estado — em vez de consultar atualizações por polling. - [Gerenciamento de Endpoints de Webhook](https://docs.spherepay.co/pt-BR/concepts/webhooks/managing-endpoints.md): Registre endpoints de webhook, assine eventos e entenda os limites e estados dos endpoints e o modelo de atualização por exclusão e recriação. - [Payloads de Eventos de Webhook](https://docs.spherepay.co/pt-BR/concepts/webhooks/event-payloads.md): A estrutura de todo payload de webhook — os campos do envelope, como o campo sequence ordena eventos e como applicationId delimita o escopo de cada evento. - [Catálogo de Eventos de Webhook](https://docs.spherepay.co/pt-BR/concepts/webhooks/event-catalog.md): Todos os assuntos de evento de webhook que você pode assinar — eventos de cliente e de transferência, com seus gatilhos e exemplos de payload. - [Verificação de Assinaturas de Webhook](https://docs.spherepay.co/pt-BR/concepts/webhooks/verifying-signatures.md): Autentique cada entrega de webhook validando sua assinatura HMAC-SHA256 — com implementações de referência em Python, JavaScript, Go, Java e C#. - [Consultando Eventos e Reenviando Entregas](https://docs.spherepay.co/pt-BR/concepts/webhooks/events-and-replays.md): Percorra todos os eventos que o SpherePay registrou, inspecione tentativas de entrega e respostas, e reenvie uma entrega com falha sob demanda. #### Dados de referência - [Referência de Códigos de País para a API do SpherePay](https://docs.spherepay.co/pt-BR/concepts/reference/supported-countries.md): O SpherePay usa códigos ISO 3166-1 alpha-3 nos endereços do cliente. Referência de códigos comuns para criar clientes e contas bancárias. - [Países Proibidos e Regiões Sancionadas](https://docs.spherepay.co/pt-BR/concepts/reference/prohibited-countries.md): Lista de referência de países e jurisdições onde contas Sphere não podem ser abertas, além das restrições regionais aplicáveis para regiões sancionadas. - [Códigos de Moeda Suportados no SpherePay](https://docs.spherepay.co/pt-BR/concepts/reference/supported-assets.md): Códigos de moeda fiat e stablecoin usados nas requisições da API SpherePay: USD, EUR, BRL, USDC, USDT e EURC, com suas redes suportadas. - [Códigos de Canal de Pagamento no SpherePay](https://docs.spherepay.co/pt-BR/concepts/reference/channel-codes.md): Referência dos códigos de rede e canal usados em transferências do SpherePay: ach, wire, sepa, pix e identificadores de redes blockchain. #### Operacional - [Limites de Taxa da API e Boas Práticas](https://docs.spherepay.co/pt-BR/concepts/operational/rate-limits.md): O SpherePay impõe 100 RPS para leitura e escrita. Aprenda a tratar erros de limite de taxa, implementar retry e solicitar aumentos temporários. ### Guias #### Introdução - [Guias de Implementação](https://docs.spherepay.co/pt-BR/implementation-guides/overview.md): 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. #### Tipos de fluxo - [Fluxos Próprios (First-Party)](https://docs.spherepay.co/pt-BR/implementation-guides/first-party-flows.md): Caminhos de implementação quando a mesma entidade legal possui ambos os lados da movimentação: transferências avulsas, Onramper Accounts e Offloader Wallets. - [Fluxos de Terceiros (Third-Party)](https://docs.spherepay.co/pt-BR/implementation-guides/third-party-flows.md): Caminhos de implementação pós-descoberta quando os fundos se movem para ou de outra entidade legal, ou quando uma plataforma atende clientes downstream. ### Soluções #### Introdução - [Soluções SpherePay: Guias de Integração por Caso de Uso](https://docs.spherepay.co/pt-BR/solutions/overview.md): Guias orientados a resultados para casos de uso do SpherePay: folha de pagamento, aceitação de pagamentos, trading, comércio internacional e tesouraria. #### Movimentação de dinheiro - [Folha de Pagamento em Stablecoin e Fiat para Equipes Globais](https://docs.spherepay.co/pt-BR/solutions/payroll.md): Pague funcionários CLT e prestadores em stablecoins ou fiat. Cubra modelos de folha de pagamento cripto-nativos e tradicionais em uma única integração. - [Aceite Pagamentos Fiat e Liquide em Stablecoins](https://docs.spherepay.co/pt-BR/solutions/payment-acceptance.md): Aceite pagamentos fiat e liquide-os automaticamente como stablecoins on-chain, sem uma chamada de API por pagamento, sobre contas virtuais Onramper. - [Trading de Moedas Fiat com Liquidação em Stablecoin](https://docs.spherepay.co/pt-BR/solutions/trading.md): Faça trading entre pares de moedas fiat usando stablecoins como ponte de liquidação: BRL ↔ USD, USD ↔ EUR e novos corredores no SpherePay. - [Financiamento de Comércio Internacional](https://docs.spherepay.co/pt-BR/solutions/cross-border-trade-finance.md): Liquide faturas e recebíveis internacionais em diferentes moedas usando stablecoins como ponte — para importadores, exportadores e plataformas de trade finance. - [Gestão de Tesouraria com Conversão Fiat para Stablecoin](https://docs.spherepay.co/pt-BR/solutions/treasury-management.md): Converta fundos da empresa entre fiat e stablecoins para operações de tesouraria — rendimento, liquidação mais rápida ou estratégia multi-moeda. ### Referência da API #### Onboarding ##### Clientes - [Criar um Cliente Individual ou Empresarial](https://docs.spherepay.co/pt-BR/api-reference/customer/post.md): Create a new customer. - [Listar Clientes com Filtros e Paginação](https://docs.spherepay.co/pt-BR/api-reference/customer/get.md): List customers with optional server-side search, filters, and sort. - [Recuperar um Cliente com Status de Verificação](https://docs.spherepay.co/pt-BR/api-reference/customer/get-id.md): Get information about a customer by their ID - [Atualizar Endereço, Telefone ou E-mail do Cliente](https://docs.spherepay.co/pt-BR/api-reference/customer/patch-id.md): Update a customer by their ID. (This endpoint only allows updates of personal information for individual customers) ##### Links de Onboarding - [Criar Cliente via Link](https://docs.spherepay.co/pt-BR/api-reference/customer/kyc-link.md): Create a customer via the hosted onboarding link flow. Returns a KYC link and its expiry. - [Regenerar o Link KYC de um Cliente](https://docs.spherepay.co/pt-BR/api-reference/customer/kyc.md): Regenerate a hosted KYC link for an existing customer. Only customers created via the onboarding link flow are supported. ##### Documentos e Verificação - [Enviar Documentos de Identidade KYC e KYB](https://docs.spherepay.co/pt-BR/api-reference/document/post.md): Upload a document for a customer. - [Gerar Link de Verificação Facial para Cliente](https://docs.spherepay.co/pt-BR/api-reference/enhanced-due-diligence/face-verification-link.md): Generate a face verification link for a customer. - [Gerar Link de Verificação Facial para UBO no KYB](https://docs.spherepay.co/pt-BR/api-reference/enhanced-due-diligence/ubo-face-verification-link.md): Generate a face verification link for a business representative. - [Enviar Código OTP para Verificação do Cliente](https://docs.spherepay.co/pt-BR/api-reference/enhanced-due-diligence/send-verification-code.md): Send an OTP code to a customer's contact information. - [Verificar Código OTP do Cliente para E-mail ou Telefone](https://docs.spherepay.co/pt-BR/api-reference/enhanced-due-diligence/verify-verification-code.md): Verify an OTP code for customer's contact information. - [Registrar Aceite dos Termos de Serviço do Cliente](https://docs.spherepay.co/pt-BR/api-reference/enhanced-due-diligence/tos.md): Create a TOS link for a customer. ##### Representantes Empresariais - [Registrar um UBO Empresarial para Verificação KYB](https://docs.spherepay.co/pt-BR/api-reference/business-representative/post.md): Create a new business representative for a customer. - [Listar Todos os Representantes Empresariais e UBOs](https://docs.spherepay.co/pt-BR/api-reference/business-representative/get.md): List all business representatives for a customer - [Recuperar um Representante Empresarial por ID](https://docs.spherepay.co/pt-BR/api-reference/business-representative/get-id.md): Retrieve a business representative by their ID - [Atualizar um Representante Empresarial Antes do KYB](https://docs.spherepay.co/pt-BR/api-reference/business-representative/patch-id.md): Update an existing business representative - [Remover um Representante Empresarial ou UBO](https://docs.spherepay.co/pt-BR/api-reference/business-representative/delete-id.md): Delete a business representative by their ID #### Contas ##### Contas Bancárias - [Registrar uma Conta Bancária do Cliente para Transferências](https://docs.spherepay.co/pt-BR/api-reference/bank-account/post.md): Create a new bank account for a customer. Requires at least one of the customer's verification profiles to be approved. - [Listar Todas as Contas Bancárias Registradas do Cliente](https://docs.spherepay.co/pt-BR/api-reference/bank-account/get.md): List all bank accounts for a customer with pagination - [Recuperar uma Conta Bancária por ID](https://docs.spherepay.co/pt-BR/api-reference/bank-account/get-id.md): Get information about a bank account by its ID - [Atualizar Configurações de Rail da Conta Bancária](https://docs.spherepay.co/pt-BR/api-reference/bank-account/patch-id.md): Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one. - [Excluir uma Conta Bancária Registrada do Cliente](https://docs.spherepay.co/pt-BR/api-reference/bank-account/delete-id.md): Delete a bank account by its ID. ##### Carteiras - [Registrar uma Carteira Cripto do Cliente para Transferências](https://docs.spherepay.co/pt-BR/api-reference/wallet/post.md): Create a new wallet and associate it with a customer. - [Listar Todas as Carteiras Cripto Registradas do Cliente](https://docs.spherepay.co/pt-BR/api-reference/wallet/get.md): List all wallets with pagination. Optionally filter by customer. - [Recuperar uma Carteira Cripto do Cliente por ID](https://docs.spherepay.co/pt-BR/api-reference/wallet/get-id.md): Get information about a wallet by its ID - [Remover uma Carteira Cripto Registrada do Cliente](https://docs.spherepay.co/pt-BR/api-reference/wallet/delete-id.md): Delete a wallet by its ID #### Movimentação de dinheiro ##### Transferências - [Criar uma Transferência On-Ramp ou Off-Ramp](https://docs.spherepay.co/pt-BR/api-reference/transfer/post.md): Create a new transfer. - [Listar Transferências On-Ramp e Off-Ramp](https://docs.spherepay.co/pt-BR/api-reference/transfer/get.md): List all transfers - [Recuperar uma Transferência com Instruções de Depósito](https://docs.spherepay.co/pt-BR/api-reference/transfer/get-id.md): Retrieve a specific transfer - [Cancelar uma Transferência Pendente Não Financiada](https://docs.spherepay.co/pt-BR/api-reference/transfer/delete-id.md): Cancel a specific transfer. ##### Cotações - [Criar uma Cotação com Taxa Bloqueada](https://docs.spherepay.co/pt-BR/api-reference/quote/post.md): Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer. - [Listar Todas as Cotações com Taxa Bloqueada da Sua Conta](https://docs.spherepay.co/pt-BR/api-reference/quote/get.md): List quotes for the application. Repeat a currency parameter to match any supplied value; source and destination filters combine. - [Recuperar uma Cotação por ID](https://docs.spherepay.co/pt-BR/api-reference/quote/get-id.md): Retrieve a single quote by its ID. - [Atualizar Status da Cotação](https://docs.spherepay.co/pt-BR/api-reference/quote/put-id.md): Mark an active quote as used or expired. Only active quotes can be updated. ##### Contas Virtuais - [Criar uma Conta Bancária Virtual para On-Ramp de Fiat](https://docs.spherepay.co/pt-BR/api-reference/virtual-account/post.md): Create a new virtual account that converts incoming fiat deposits to crypto. - [Listar Todas as Contas Bancárias Virtuais Onramper](https://docs.spherepay.co/pt-BR/api-reference/virtual-account/get.md): List all active virtual accounts for the authenticated application. - [Recuperar uma Onramper Account por ID](https://docs.spherepay.co/pt-BR/api-reference/virtual-account/get-id.md): Retrieve a virtual account by its ID. - [Atualizar a Carteira de Destino de uma Onramper Account](https://docs.spherepay.co/pt-BR/api-reference/virtual-account/patch.md): Update the destination, network, or fee configuration of a virtual account. - [Listar Transferências de uma Onramper Account](https://docs.spherepay.co/pt-BR/api-reference/virtual-account/list-transfers.md): List the transfer history for a specific virtual account. Deprecated: the main `GET /v2/transfer` endpoint already returns virtual account transfers and will support filtering to the same effect. - [Desativar uma Conta Bancária Virtual Onramper](https://docs.spherepay.co/pt-BR/api-reference/virtual-account/deactivate.md): Deactivate a virtual account so it no longer accepts deposits. - [Reativar uma Onramper Account Desativada](https://docs.spherepay.co/pt-BR/api-reference/virtual-account/reactivate.md): Reactivate a previously deactivated virtual account. ##### Offloader Wallets - [Criar uma Offloader Wallet para Pagamentos em Cripto](https://docs.spherepay.co/pt-BR/api-reference/offloader-wallet/post.md): Create a new offloader wallet. - [Listar Todas as Offloader Wallets da Sua Conta](https://docs.spherepay.co/pt-BR/api-reference/offloader-wallet/get.md): List all offloader wallets - [Recuperar uma Offloader Wallet por ID](https://docs.spherepay.co/pt-BR/api-reference/offloader-wallet/get-id.md): Get an offloader wallet by id - [Atualizar o Destino Bancário de uma Offloader Wallet](https://docs.spherepay.co/pt-BR/api-reference/offloader-wallet/patch-id.md): Update an offloader wallet by id #### Webhooks ##### Endpoints de Webhook - [Registrar um Endpoint de Webhook para Entrega de Eventos](https://docs.spherepay.co/pt-BR/api-reference/webhook-endpoints/post.md): Register a new webhook endpoint to receive event deliveries for the specified subscribed events. - [Listar Todos os Endpoints de Webhook Registrados](https://docs.spherepay.co/pt-BR/api-reference/webhook-endpoints/get.md): List all webhook endpoints for the authenticated application, with optional filtering by status and subscribed event types. - [Recuperar um Endpoint de Webhook por ID](https://docs.spherepay.co/pt-BR/api-reference/webhook-endpoints/get-id.md): Retrieve a webhook endpoint by its ID. - [Excluir um Endpoint de Webhook](https://docs.spherepay.co/pt-BR/api-reference/webhook-endpoints/delete-id.md): Delete a webhook endpoint by its ID. Future events will no longer be delivered to it. ##### Eventos - [Listar Eventos e seu Status de Entrega](https://docs.spherepay.co/pt-BR/api-reference/events/get.md): List events for the authenticated application, with optional filtering by webhook endpoint, event type, delivery status, and creation date range. - [Recuperar um Evento com o Histórico Completo de Entregas](https://docs.spherepay.co/pt-BR/api-reference/events/get-id.md): Retrieve an event by its ID. - [Reenviar uma Entrega de Evento com Falha](https://docs.spherepay.co/pt-BR/api-reference/events/replay.md): Redeliver an event to its webhook endpoint by the ID of a prior delivery attempt. ### Notas - [Notas de Lançamento e Changelog da API SpherePay](https://docs.spherepay.co/pt-BR/changelog.md): Atualizações mais recentes da API SpherePay: novos recursos, mudanças incompatíveis, descontinuações, conformidade e novos rails e ativos suportados. ## OpenAPI Specs - [spherepay](/openapi/spherepay.yaml) ## Optional - [FAQ](https://spherepay-knowledge-base.help.usepylon.com/)