Em resumo
A API de Saque Fiat da Blockradar permite converter stablecoins suportadas em moeda fiduciária e transferir fundos para contas bancárias. Você pode consultar ativos suportados, validar contas bancárias, obter cotações e executar saques a partir de carteiras principais e endereços filhos.
A API de Saque Fiat da Blockradar permite converter stablecoins suportadas em moeda fiduciária e transferir fundos para contas bancárias. Você pode consultar ativos suportados, validar contas bancárias, obter cotações e executar saques a partir de carteiras principais e endereços filhos.

Pré-requisitos
Antes de usar Saque Fiat, certifique-se de ter:Requisito de compliance
Conclua o onboarding de parceiro antes de solicitar acesso ao Saque Fiat (veja
Requisitos de compliance abaixo).
Chave API
Obtenha sua chave API no Painel da Blockradar.
Vá até Developers para gerar uma.
Carteira criada
Crie uma carteira pelo painel. Você precisará do
walletId para as operações de saque.ID do ativo
Consulte os ativos fiat suportados em Obter Ativos Suportados.
Como funciona
O Saque Fiat segue uma sequência simples:Descobrir ativos
Consulte os ativos suportados para saques.
Obter moedas fiat
Recupere todas as moedas suportadas.
Obter taxas
Consulte a taxa de câmbio atual para o ativo selecionado.
Verificar conta
Valide os dados da conta bancária antes de iniciar um saque.
Obter cotação
Estime taxas e câmbio para o valor solicitado.
Executar
Envie o saque para processamento.
Requisitos de compliance
Antes de acessar o Saque Fiat, conclua o processo de onboarding de compliance aplicável à cobertura de moeda de pagamento que você precisa.Escolha sua trilha de onboarding
- Somente NGN (Naira): Preencha o formulário de onboarding apenas para Naira.
- Outras moedas africanas: Conclua o onboarding de parceiros para moedas africanas.
Se você precisar de acesso a NGN e também a outras moedas africanas suportadas, conclua os dois fluxos de onboarding.
Requisito de aprovação
O acesso ao Saque Fiat é habilitado após análise de compliance e aprovação da trilha de onboarding selecionada.Carteira principal vs endereço filho
O Saque Fiat está disponível em dois níveis:Carteira principal
Saque pela carteira principal. Ideal para operações de tesouraria.
Endereço filho
Saque a partir de um endereço filho específico. Útil para fluxos por usuário.
Endpoints
| Operação | Carteira principal | Endereço filho |
|---|---|---|
| Obter ativos suportados | GET /v1/wallets/{walletId}/withdraw/fiat/assets | — |
| Obter instituições | GET /v1/wallets/{walletId}/withdraw/fiat/institutions | — |
| Obter taxas de câmbio | GET /v1/wallets/{walletId}/withdraw/fiat/rates | — |
| Obter moedas | GET /v1/wallets/{walletId}/withdraw/fiat/currencies | — |
| Verificar conta da instituição | POST /v1/wallets/{walletId}/withdraw/fiat/institution-account-verification | — |
| Obter cotação | POST /v1/wallets/{walletId}/withdraw/fiat/quote | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/quote |
| Executar | POST /v1/wallets/{walletId}/withdraw/fiat/execute | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute |
Fluxo típico
- Consulte os ativos suportados para escolher a stablecoin que será sacada.
- Liste as instituições e selecione um identificador de banco/instituição.
- Verifique a conta para confirmar nome e dados da conta.
- Obtenha uma cotação para exibir taxas e câmbio antes da execução.
- Execute o saque e acompanhe o status no seu sistema.
Etapa 1: Obter uma cotação
Sempre solicite uma cotação antes de executar um saque para exibir a taxa e os custos ao usuário.Parâmetros da requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
assetId | string | Sim | ID do ativo stablecoin a ser sacado |
amount | number | Sim | Valor a sacar nas unidades do ativo |
currency | string | Sim | Moeda fiat de destino (ex.: NGN) |
accountIdentifier | string | Sim | Número da conta bancária ou identificador |
institutionIdentifier | string | Sim | Código do banco/instituição |
Exemplo de cotação
Etapa 2: Executar o saque
Depois de aceitar a cotação, execute o saque com os mesmos dados (e qualquer código/OTP exigido).Parâmetros da requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
assetId | string | Sim | ID do ativo stablecoin a ser sacado |
amount | number | Sim | Valor a sacar nas unidades do ativo |
currency | string | Sim | Moeda fiat de destino (ex.: NGN) |
accountIdentifier | string | Sim | Número da conta bancária ou identificador |
institutionIdentifier | string | Sim | Código do banco/instituição |
code | string | Não | Código de verificação, se exigido pelo provedor |
Exemplo de execução
Resposta de execução
Webhooks
Acompanhe o status do saque com os seguintes eventos de webhook:| Evento | Descrição |
|---|---|
offramp.processing | O saque está sendo processado |
offramp.success | O saque foi concluído com sucesso |
offramp.failed | O saque falhou |
Exemplo de payload de webhook
Exemplo de fluxo completo
Aqui está uma implementação completa mostrando o fluxo verificar → cotar → executar:Respostas de erro
Dados bancários inválidos
Dados bancários inválidos
Moeda não suportada
Moeda não suportada
Ativo não suportado
Ativo não suportado
Funcionalidade não habilitada
Funcionalidade não habilitada
Saldo insuficiente
Saldo insuficiente
Saldo nativo insuficiente
Saldo nativo insuficiente
Saldo insuficiente na carteira principal
Saldo insuficiente na carteira principal
Boas práticas
Experiência do usuário
- Verifique contas primeiro: Sempre confirme o nome da conta antes de mostrar uma cotação
- Mostre o custo total: Exiba câmbio, taxa de rede e valor total
- Mostre o estado de processamento: Use webhooks para atualizar usuários em tempo real
Segurança
- Valide entradas: Garanta que moeda, instituição e identificadores de conta estejam bem formatados
- Use referências: Rastreie saques com uma
referenceúnica - Confirme via webhooks: Trate
offramp.successcomo fonte final da verdade
Performance
- Faça cache das listas de instituições: Atualize periodicamente em vez de consultar a cada requisição
- Reutilize metadados de ativos: Faça cache de ativos e moedas suportadas
- Tente novamente em erros transitórios: Use backoff exponencial para respostas 5xx
Referência da API
| Endpoint | Descrição |
|---|---|
| Obter Ativos Suportados | Lista stablecoins suportadas |
| Obter Instituições | Lista instituições por moeda |
| Obter Taxas de Câmbio | Consulta a taxa de câmbio para uma cotação |
| Obter Moedas | Lista moedas fiat suportadas |
| Verificar Conta da Instituição | Verifica dados da conta bancária |
| Cotação da Carteira Principal | Obtém cotação da carteira principal |
| Execução da Carteira Principal | Executa saque da carteira principal |
| Cotação do Endereço Filho | Obtém cotação de um endereço filho |
| Execução do Endereço Filho | Executa saque de um endereço filho |
Suporte
- Email: [email protected]
- Documentação: Referência da API

