customer), registrar um instrumento de transferência e executar uma transferência. Esta página explica cada etapa e os conceitos-chave por trás delas.
Sequência de integração
Autenticar
Gere uma chave de API no painel do SpherePay. Toda requisição à API deve incluir essa chave como Bearer token no cabeçalho
Authorization. Veja Autenticação para instruções de configuração.Criar e verificar um cliente
Um cliente representa o usuário final ou a empresa em cujo nome você está movimentando dinheiro. Antes de qualquer transferência ser iniciada, o cliente deve passar pela verificação de identidade — KYC para pessoas físicas, KYB para empresas. Nenhuma transferência pode ser criada sem um registro de cliente verificado.
Registrar um instrumento de transferência
Assim que seu cliente for verificado, vincule a conta ou carteira que servirá como origem (
source) ou destino (destination) da transferência. Para transferências de on-ramp, você vincula uma conta bancária como origem fiat e uma carteira como destino cripto. Para off-ramp, a direção é invertida.Etapa 1 — Criar e verificar um cliente
Um cliente no SpherePay representa um usuário final ou empresa em cujo nome você está movimentando dinheiro. Antes de um cliente poder realizar transações, ele deve passar pela verificação de identidade:- Clientes pessoas físicas passam por um fluxo de KYC (Know Your Customer). Isso envolve o envio de documento de identidade e uma verificação de vivacidade facial.
- Clientes empresariais passam por um fluxo de KYB (Know Your Business). Isso envolve o envio de documentos da empresa e a verificação de um diretor ou representante autorizado.
Etapa 2 — Registrar um instrumento de transferência
Assim que um cliente for verificado, registre o instrumento de transferência que servirá como origem ou destino de uma transferência:- Contas bancárias (
bank_account) — usadas como origem fiat no on-ramp ou como destino fiat no off-ramp. - Carteiras (
wallet) — usadas como destino cripto no on-ramp ou como origem cripto no off-ramp.
Etapa 3 — Executar uma transferência
Com um cliente verificado e os instrumentos adequados configurados, chamePOST /v2/transfer para iniciar a movimentação de recursos. Você especifica o cliente, o instrumento de origem, o instrumento de destino e o valor. O SpherePay cuida de todo o resto.
Consulte Transferências para detalhes completos sobre tipos de transferência, status e rails suportados.
Conceitos-chave
| Conceito | Descrição |
|---|---|
Cliente (Customer) | Uma pessoa física ou jurídica em cujo nome as transferências são executadas. Deve ser verificado via KYC/KYB antes de qualquer transferência ser iniciada. |
Conta Bancária (Bank Account) | Uma conta bancária fiat vinculada a um cliente, usada para enviar ou receber fundos fiat. |
Carteira (Wallet) | Um endereço de carteira cripto vinculado a um cliente, usado para enviar ou receber stablecoins. |
Transferência (Transfer) | Um evento único de movimentação de recursos entre a conta bancária e a carteira de um cliente, em qualquer direção. |
O que o SpherePay cuida por você
Após você enviar uma transferência, o SpherePay gerencia todo o ciclo de vida:- Orquestração da verificação de identidade via Sumsub
- Triagem de conformidade e verificações de sanções
- Conversão de fiat para cripto e de cripto para fiat
- Liquidação e pagamento via rails bancários e blockchain subjacentes
O SpherePay não mantém um ambiente de sandbox separado. Os testes ocorrem diretamente nos sistemas de produção usando informações de identidade reais. Isso garante que sua integração seja validada com os mesmos parceiros de verificação de identidade e bancários que seus clientes utilizarão.