Notas de Lançamento e Changelog da API SpherePay

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.

Onboarding/Compliance

Documentos de identidade digitais brasileiros

A SpherePay agora aceita dois valores adicionais de documentType em POST /v2/document para documentos de identidade digitais do Brasil:

br_digital_drivers — CNH digital
br_digital_id — RG digital

Esses tipos são válidos apenas com country: "BRA". Envie uma única imagem e omita o campo side. Eles são suportados para clientes individuais (target: "customer") e representantes empresariais (target: "business_representative"). Documentos físicos brasileiros continuam usando drivers e id_card com frente e verso.Para a lista completa de tipos de ID aceitos, consulte Tipos de ID e CPF/CNPJ aceitos.

APICustomersKYC

Novo: campos de verificação EEA para clientes pessoas físicas

Clientes pessoas físicas residentes na região EEA+ agora exigem accountPurpose (campo novo), countryOfBirth e nationality em personalInformation antes de poderem ser enviados para verificação.Esses campos são opcionais na criação e podem ser fornecidos depois via PATCH /v2/customer/{id}. Até que sejam fornecidos, eles aparecem como códigos de requisito country_of_birth, nationality e account_purpose no perfil de verificação kyc_profile_a do cliente. Clientes fora da EEA+ não são afetados.Clientes EEA+ existentes podem mostrar esses como novos requisitos pendentes. Preencha-os com PATCH /v2/customer/{id} — a validação é executada no estado mesclado do cliente.Links de verificação hospedados coletam os novos dados automaticamente. Integradores que usam links hospedados não precisam de alterações.Para valores de campos, exigência e um exemplo de requisição, consulte Residentes EEA+.

APICustomersKYB

Novo: número de registro empresarial EEA e requisitos ampliados de pessoas associadas

Empresas constituídas na EEA+ devem fornecer businessInformation.registrationNumber mais um registrationNumberType novo por país (por exemplo siren, kvk, crn). O número de registro é armazenado e verificado separadamente do ID fiscal — não envie um número de IVA ou fiscal como número de registro.Representantes empresariais passam a aceitar o papel director. ownershipPercentage agora aceita 0–100 (antes o mínimo era 25); o papel ubo ainda exige ≥ 25. Empresas EEA+ devem ter pelo menos uma pessoa de controle e concluir o KYC para todos os diretores, signatários, pessoas de controle e sócios com ≥ 25%.Itens pendentes aparecem como códigos de requisito registration_number, eea_control_person_present e eea_ap_kyc_scope em kyb_profile_a. Representantes de empresas EEA+ também devem fornecer countryOfBirth e nationality, que aparecem no perfil ubo_kyc_profile_a de cada representante.Clientes e representantes EEA+ existentes podem mostrar esses como novos requisitos pendentes. Preencha-os com PATCH /v2/customer/{id} e PATCH /v2/business-representative/{id} — a validação é executada no estado mesclado.Links de verificação hospedados coletam os novos dados automaticamente. Integradores que usam links hospedados não precisam de alterações.Para tipos de registro, papéis de representantes e códigos de requisito, consulte Empresas EEA+.

TransfersBank 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)

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.

O suporte a SWIFT inclui pagamentos first-party e third-party. Leia mais sobre os requisitos para pagamentos third-party aqui.

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.

DashboardOnboarding/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.

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.

DashboardOnboarding/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.

TransfersBank AccountsAssets

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"].

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.

Para detalhes, consulte API de Transferências — Restrições BRL/PIX e Rails e Moedas Suportados.

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

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.

WalletsTransfersAssets

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.

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.

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:

Para detalhes completos, consulte o guia KYB via API.

Transfers

Descontinuando a API de Taxas de Transferência

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.

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.

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:

O endpoint Criar Cliente 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 ou KYC via Link para um caminho de integração mais rápido.

Bank AccountsWalletsTransfers

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.

WalletsTransfers

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:

{
  "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:

{
  "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
  "amount": "2",
  "source": {
    "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
    "network": "wire",
    "currency": "usd"
  },
  "destination": {
    "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
    "network": "starknet",
    "currency": "usdc"
  }
}

Onboarding/Compliance

Descontinuando `/v1/customer`

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.

/v2/customer é o novo padrão para criar e gerenciar clientes e continuará recebendo novos recursos. Consulte a referência da API de Clientes para detalhes de migração.

​Documentos de identidade digitais brasileiros

​Novo: campos de verificação EEA para clientes pessoas físicas

​Novo: número de registro empresarial EEA e requisitos ampliados de pessoas associadas

​Pagamentos internacionais via SWIFT

​Gerencie offloader wallets pelo dashboard

​Incorpore seus clientes e visualize as contas externas deles

​Adicione contas e crie transferências em nome dos seus clientes

​Redesign da Navegação do Dashboard e Fluxo de Transferência

​Transferências BRL/PIX Agora Suportadas

​Pagamentos Wire Nomeados

​Padrões de Onboarding API-First

​API de Offloader Wallets + Suporte a EURC

​API de Offloader Wallets

​EURC agora suportado

​Suite de API de Clientes para Clientes Empresariais

​Descontinuando a API de Taxas de Transferência

​Suite de API de Clientes para Clientes Individuais

​API de Onramper Accounts

​Suporte à Rede Starknet

​Descontinuando /v1/customer

Documentos de identidade digitais brasileiros

Novo: campos de verificação EEA para clientes pessoas físicas

Novo: número de registro empresarial EEA e requisitos ampliados de pessoas associadas

Pagamentos internacionais via SWIFT

Gerencie offloader wallets pelo dashboard

Incorpore seus clientes e visualize as contas externas deles

Adicione contas e crie transferências em nome dos seus clientes

Redesign da Navegação do Dashboard e Fluxo de Transferência

Transferências BRL/PIX Agora Suportadas

Pagamentos Wire Nomeados

Padrões de Onboarding API-First

API de Offloader Wallets + Suporte a EURC

API de Offloader Wallets

EURC agora suportado

Suite de API de Clientes para Clientes Empresariais

Descontinuando a API de Taxas de Transferência

Suite de API de Clientes para Clientes Individuais

API de Onramper Accounts

Suporte à Rede Starknet

Descontinuando `/v1/customer`