> ## 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.

# Notas de Lançamento e Changelog da API SpherePay

> Atualizações mais recentes da API SpherePay: novos recursos, mudanças incompatíveis, descontinuações, conformidade e novos rails e ativos suportados.

Saiba mais sobre todas as atualizações mais recentes do produto API SpherePay. Aqui você encontrará informações sobre novos recursos, mudanças de API, descontinuações, atualizações de conformidade e novos rails/ativos. Se tiver alguma dúvida, entre em contato com [support@spherepay.co](mailto:support@spherepay.co).

<Update label="June 30, 2026" tags={["Transfers", "Bank Accounts"]}>
  ## Pagamentos internacionais via SWIFT

  A SpherePay agora oferece suporte a **SWIFT** para pagamentos off-ramp em USD para contas bancárias internacionais. Os fundos são convertidos de stablecoin para USD e enviados como uma **transferência internacional (wire) pela rede SWIFT**, encaminhados ao banco do beneficiário por meio de até **três bancos intermediários (correspondentes)** quando necessário.

  **Registrando uma conta bancária de beneficiário SWIFT:**

  * Crie uma conta bancária em USD com `currency: "usd"` e `networks: ["swift"]`
  * Forneça o `accountNumber` (IBAN ou BBAN) e o `bic` do banco do beneficiário (8 ou 11 caracteres)
  * Opcionalmente, inclua `intermediaryBics` — uma lista ordenada de até 3 BICs de bancos correspondentes (cada um com 8 ou 11 caracteres, sem duplicatas)

  <Note>
    O acesso ao SWIFT exige o **perfil de verificação C**. Uma conta bancária SWIFT em USD não pode ser criada até que o perfil C seja aprovado — entre em contato com seu representante da SpherePay para habilitá-lo.
  </Note>

  O suporte a SWIFT inclui pagamentos first-party e third-party. Leia mais sobre os requisitos para pagamentos third-party [aqui](/pt-BR/implementation-guides/third-party-flows).
</Update>

<Update label="June 29, 2026" tags={["Dashboard"]}>
  ## Gerencie offloader wallets pelo dashboard

  Os integradores agora podem gerar e acompanhar offloader wallets diretamente pelo dashboard.

  * **Gere offloader wallets** — crie novos endereços de offloader wallet sem uma chamada de API.
  * **Histórico de transações da wallet** — visualize o histórico completo de transações de cada offloader wallet, incluindo as transferências associadas.
</Update>

<Update label="June 24, 2026" tags={["Dashboard", "Onboarding/Compliance"]}>
  ## Incorpore seus clientes e visualize as contas externas deles

  Os integradores agora podem criar e incorporar seus clientes finais diretamente pelo dashboard, como parte do lançamento contínuo do Integrators Dashboard.

  * **Crie e incorpore um cliente** — adicione um cliente final (empresa ou pessoa física) e execute a verificação KYB ou KYC, com um link de Termos de Serviço por cliente e o status de verificação em tempo real.
  * **Contas externas do cliente** — visualize as contas externas de um cliente diretamente na aba Cliente.
</Update>

<Update label="June 12, 2026" tags={["Dashboard"]}>
  ## Adicione contas e crie transferências em nome dos seus clientes

  Os integradores agora podem gerenciar a atividade em nome dos seus clientes diretamente pelo dashboard, como parte da primeira fase do lançamento do novo Integrators Dashboard.

  * **Adicione contas de clientes** — adicione contas externas em nome dos seus clientes sem sair do dashboard.
  * **Crie transferências em nome dos seus clientes** — inicie transferências dessas contas em nome dos seus clientes.
  * **Detalhes de transferência aprimorados** — uma visão renovada de confirmação e detalhes facilita a revisão de cada transferência.
</Update>

<Update label="April 11, 2026" tags={["Dashboard", "Onboarding/Compliance"]}>
  ## Redesign da Navegação do Dashboard e Fluxo de Transferência

  O dashboard do SpherePay foi reformulado com navegação mais clara e um fluxo de Transferência reconstruído.

  **Atualizações de navegação:**

  * O Onboarding foi movido para fora da seção Transferências para seu próprio item de barra lateral "Começar", dando aos clientes um caminho mais claro pela plataforma desde o primeiro dia.
  * "Contas Bancárias" foi renomeado para "Contas Externas" para refletir melhor como o produto funciona.

  **Redesign do fluxo de Transferência:** O fluxo de Transferência é agora uma jornada baseada em etapas com uma página de entrada dedicada. Você pode escolher entre mover seus próprios fundos, enviar para destinatários ou configurar contas Autoramp.

  **Offloader Wallets:** Os Offloader Wallets agora têm uma página dedicada em Contas Autoramp, com descrições claras do produto e orientação de uso para que os clientes tenham contexto completo antes de começar.
</Update>

<Update label="April 9, 2026" tags={["Transfers", "Bank Accounts", "Assets"]}>
  ## Transferências BRL/PIX Agora Suportadas

  O SpherePay agora suporta transferências em BRL (Real Brasileiro) via a rede de pagamentos instantâneos PIX.

  **Rotas suportadas:**

  * Off-ramp: USDC/USDT no Polygon, Ethereum, Base ou Tron → PIX BRL
  * On-ramp: PIX BRL → USDC/USDT no Polygon, Ethereum, Base ou Tron
  * Limites de transferência: R$1,00–R$7.500,00 por transferência

  **Restrições específicas do BRL:**

  * Apenas `integratorBpsFeeRate` é suportado para taxas (`integratorFixedFee` não é permitido).
  * Solana não é suportada para transferências BRL.
  * Contas bancárias PIX requerem `currency: "brl"` e `networks: ["pix"]`.

  <Note>
    Transferências BRL requerem um perfil de verificação separado (`kyc_profile_b` / `kyb_profile_b`). Entre em contato com seu representante SpherePay para acesso.
  </Note>

  Para detalhes, consulte [API de Transferências — Restrições BRL/PIX](/pt-BR/concepts/transfers/overview#restrições-de-transferências-brlpix) e [Rails e Moedas Suportados](/pt-BR/concepts/transfers/supported-rails).
</Update>

<Update label="April 7, 2026" tags={["Transfers", "Bank Accounts"]}>
  ## Pagamentos Wire Nomeados

  Pagamentos wire em USD agora exibem o nome da sua empresa como remetente em vez de "Sphere". Isso é ativado automaticamente quando um cliente é aprovado — sem configuração manual necessária.

  Clientes aprovados existentes que realizaram transações nos últimos 3 meses foram atualizados retroativamente e verão essa mudança refletida imediatamente.
</Update>

<Update label="March 12, 2026" tags={["Onboarding/Compliance"]}>
  ## Padrões de Onboarding API-First

  O SpherePay agora adota por padrão um modelo de onboarding simplificado para aplicações integradas via API. Verificações de vivacidade KYC e UBO, verificação OTP por telefone e e-mail e assinatura de MSA não são mais exigidas durante o onboarding quando essas etapas são tratadas pelo integrador.

  Essas capacidades permanecem totalmente suportadas e podem ser habilitadas como requisitos opt-in por aplicação. As aplicações existentes mantêm seu comportamento atual — apenas novas aplicações recebem os padrões simplificados.

  Para mais informações, consulte o guia [Clientes e Onboarding](/pt-BR/concepts/onboarding/overview).
</Update>

<Update label="March 3, 2026" tags={["Wallets", "Transfers", "Assets"]}>
  ## API de Offloader Wallets + Suporte a EURC

  ### API de Offloader Wallets

  Os Offloader Wallets são carteiras de conversão automática de cripto para fiat que permitem que seus clientes recebam stablecoins e tenham-nas automaticamente liquidadas em uma conta bancária vinculada.

  **Stablecoins e redes suportadas:**

  * USDC no Arbitrum, Avalanche, Base, Ethereum, Polygon e Solana
  * USDT no Ethereum e Tron
  * EURC no Base, Ethereum e Solana

  **Destinos fiat suportados:**

  * USD via ACH e Wire
  * EUR via SEPA

  Para detalhes completos, consulte o [guia de Offloader Wallets](/pt-BR/concepts/automation/offloader-wallets).

  ### EURC agora suportado

  O EURC agora está disponível nos produtos de on-ramp e off-ramp do SpherePay nas redes Base, Ethereum e Solana.
</Update>

<Update label="January 13, 2026" tags={["Onboarding/Compliance"]}>
  ## Suite de API de Clientes para Clientes Empresariais

  Suporte completo de API para onboarding e verificação de clientes empresariais, incluindo registro de UBO — dando a você controle total sobre a UX de onboarding sem redirecionar clientes para um fluxo externo.

  Novos endpoints disponíveis:

  * [Registrar representante empresarial](/pt-BR/api-reference/business-representative/post)
  * [Enviar documentos de identificação do UBO](/pt-BR/api-reference/document/post)
  * [Solicitar verificação de vivacidade facial para UBO](/pt-BR/api-reference/enhanced-due-diligence/ubo-face-verification-link)
  * [Enviar UBO para verificação](/pt-BR/concepts/onboarding/business-kyb#poll-for-verification-result)

  Para detalhes completos, consulte o [guia KYB via API](/pt-BR/concepts/onboarding/business-kyb).
</Update>

<Update label="January 7, 2026" tags={["Transfers"]}>
  ## Descontinuando a API de Taxas de Transferência

  <Warning>
    **Ação necessária até 14 de janeiro de 2026.** O endpoint `/v1/transfer/fee` será removido em 14 de janeiro de 2026. Migre antes desta data para evitar interrupções.
  </Warning>

  As taxas de transferência agora são declaradas diretamente no corpo da requisição de transferência. O endpoint de taxa independente não é mais necessário e será retirado.
</Update>

<Update label="December 1, 2025" tags={["Onboarding/Compliance"]}>
  ## Suite de API de Clientes para Clientes Individuais

  Suporte completo de API para onboarding e verificação de clientes individuais — habilitando fluxos KYC de ponta a ponta dentro do seu próprio produto sem redirecionar clientes para uma página externa.

  Novos endpoints disponíveis:

  * [Enviar documentos obrigatórios](/pt-BR/api-reference/document/post)
  * [Enviar e verificar OTP por e-mail](/pt-BR/api-reference/enhanced-due-diligence/send-verification-code)
  * [Enviar e verificar OTP por telefone](/pt-BR/api-reference/enhanced-due-diligence/send-verification-code)
  * [Solicitar verificação de vivacidade facial](/pt-BR/api-reference/enhanced-due-diligence/face-verification-link)

  O endpoint [Criar Cliente](/pt-BR/api-reference/customer/post) agora aceita os seguintes campos para KYC via API:

  * `personalInformation.taxIdentificationNumber`
  * `personalInformation.taxIdentificationNumberType`
  * `personalInformation.taxIdentificationNumberCountry`
  * `personalInformation.taxIdentificationNumberDescription`

  Para detalhes completos, consulte o [guia KYC via API](/pt-BR/concepts/onboarding/individual-kyc) ou [KYC via Link](/pt-BR/concepts/onboarding/kyc-via-link) para um caminho de integração mais rápido.
</Update>

<Update label="August 21, 2025" tags={["Bank Accounts", "Wallets", "Transfers"]}>
  ## API de Onramper Accounts

  Os Onramper Accounts geram contas bancárias virtuais dedicadas que convertem automaticamente depósitos fiat recebidos em stablecoins e os entregam on-chain — sem intervenção manual necessária.

  * Gere contas bancárias dedicadas por cliente ou aplicação
  * Converta automaticamente depósitos em USD/EUR para USDC ou USDT
  * Entregue os fundos convertidos diretamente para qualquer endereço de carteira on-chain

  Para detalhes completos, consulte o [guia de Onramper Accounts](/pt-BR/concepts/automation/onramper-accounts).
</Update>

<Update label="June 18, 2025" tags={["Wallets", "Transfers"]}>
  ## Suporte à Rede Starknet

  O Starknet agora é suportado para transferências `onRamp` e `offRamp` de USDC. Use `"network": "starknet"` no `source` ou `destination` da sua requisição de transferência.

  **Off-ramp via Starknet:**

  ```json theme={"dark"}
  {
    "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
    "amount": "1.12",
    "source": {
      "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
      "network": "starknet",
      "currency": "usdc"
    },
    "destination": {
      "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
      "network": "ach",
      "currency": "usd"
    }
  }
  ```

  **On-ramp via Starknet:**

  ```json theme={"dark"}
  {
    "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
    "amount": "2",
    "source": {
      "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
      "network": "wire",
      "currency": "usd"
    },
    "destination": {
      "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
      "network": "starknet",
      "currency": "usdc"
    }
  }
  ```
</Update>

<Update label="June 3, 2025" tags={["Onboarding/Compliance"]}>
  ## Descontinuando `/v1/customer`

  <Warning>
    **Ação necessária até 6 de junho de 2025.** O endpoint `/v1/customer` será descontinuado em 6 de junho de 2025. Migre para `/v2/customer` antes desta data.
  </Warning>

  `/v2/customer` é o novo padrão para criar e gerenciar clientes e continuará recebendo novos recursos. Consulte a [referência da API de Clientes](/pt-BR/api-reference/customer/post) para detalhes de migração.
</Update>
