Documentation Index
Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
Use this file to discover all available pages before exploring further.
Em resumo
O Blockradar Checkout permite aceitar pagamentos em stablecoins por meio de links compartilháveis, sem necessidade de contas de cliente ou integrações complexas. Crie um link, compartilhe e receba pagamentos diretamente em sua wallet.
O Blockradar Checkout permite aceitar pagamentos em stablecoins por meio de links compartilháveis, sem necessidade de contas de cliente ou integrações complexas. Crie um link, compartilhe e receba pagamentos diretamente em sua wallet.
Pré-requisitos
Antes de criar links de pagamento, certifique-se de ter:Chave de API
Obtenha sua chave de API no Dashboard do Blockradar. Acesse Developers para gerar uma.
Master Wallet criada
Crie uma master wallet por meio da API Create Wallet ou pelo dashboard. Os links de pagamento estão vinculados a uma wallet.
Plano de Checkout ativo
Garanta que o recurso de Checkout esteja habilitado em sua conta. Entre em contato com [email protected] se precisar ativá-lo.
Webhook configurado (opcional)
Configure webhooks para receber notificações de pagamento em tempo real. Consulte Webhooks para obter detalhes de configuração.
Introdução
Links de pagamento são URLs compartilháveis que permitem que qualquer pessoa envie pagamentos em stablecoins para sua wallet. São perfeitos para:- E-commerce: Enviar para clientes para compras de produtos
- Faturamento: Incluir em faturas por serviços prestados
- Doações: Compartilhar nas redes sociais ou em sites
- Pagamentos em marketplace: Facilitar transações peer-to-peer
- Cobrança por assinatura: Coleta de pagamentos recorrentes
Como funcionam os links de pagamento
Criação
Crie um link de pagamento com parâmetros específicos como valor, nome,
descrição e limites de pagamento.
Compartilhamento
Compartilhe a URL gerada com seus clientes por e-mail, mensagens ou
incorpore-a em seu site.
Pagamento
Os clientes clicam no link, inserem seus dados de pagamento e concluem a
transação.
Confirmação
Você recebe notificações por webhook e pode acompanhar o status do pagamento em tempo real.
Recursos dos links de pagamento
- Parâmetros personalizáveis: Defina valor, descrição, limites de pagamento e metadata
- URLs compartilháveis: Gere links de pagamento exclusivos para cada transação
- Pré-preenchimento de cliente: Pré-preencha os dados do cliente por meio de parâmetros de query na URL
- Acompanhamento em tempo real: Monitore o status do pagamento e receba notificações por webhook
- Suporte multi-rede: Aceite pagamentos em diferentes redes blockchain
- Integração com auto-sweep: Os fundos são automaticamente consolidados na master wallet
Suporte multi-ativo
- USDT, USDC, DAI, BUSD em várias blockchains
- Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Tron, Solana, Celo
- Conversão e roteamento automáticos para uma experiência ideal do usuário
Configuração flexível
- Valores fixos para produtos/serviços específicos
- Valores variáveis para doações ou pagamentos personalizados
- Limites de pagamento para garantir pagamentos pontuais
- Metadata personalizada para acompanhamento e analytics
- Notificações por webhook para atualizações em tempo real
Segurança e compliance
- Triagem AML em todos os pagamentos recebidos
- Validação e verificação de endereços
- Detecção e prevenção de fraudes
- Compliance regulatório em diferentes jurisdições
Fluxo de pagamento
1. Criação do link de pagamento
Quando você cria um link de pagamento, o Blockradar retorna uma URL de pagamento exclusiva:2. Pré-preenchimento de cliente com parâmetros de query
Você pode aprimorar a URL de pagamento com parâmetros de query para pré-preencher automaticamente os dados do cliente na página de pagamento:name- Nome do cliente (aparece na página de pagamento)email- Endereço de e-mail do clientereference- Referência personalizada que será incluída nas respostas da transaçãoamount- Pré-preenche o valor do pagamento (substitui o valor padrão do link, se definido)redirectUrl- URL para redirecionamento após a conclusão do pagamento
3. Redirecionamento após o pagamento
Quando umredirectUrl é fornecido, os clientes serão automaticamente redirecionados para a URL especificada após a conclusão do processamento do pagamento. A URL de redirecionamento incluirá os seguintes parâmetros de query:
Parâmetros de query do redirecionamento:
status- Status do pagamento (success,failed,pending)tx_reference- ID de referência da transaçãoreference- Sua referência personalizada (se fornecida)slug- Identificador do link de pagamento
O redirecionamento ocorre apenas após a conclusão do processamento do pagamento. Se nenhum
redirectUrl for fornecido, os clientes verão a página padrão de conclusão
de pagamento.4. Configuração do valor
Os links de pagamento suportam dois modos de valor: Valor fixo (predefinido)- Quando você especifica um
amountdurante a criação, os clientes não podem modificar o valor do pagamento - Ideal para produtos ou serviços específicos com preço definido
- Exemplo: Compra de produto por exatamente US$ 99,99
- Quando nenhum
amounté especificado, os clientes podem inserir seu próprio valor de pagamento - Perfeito para doações, gorjetas ou cenários de preços flexíveis
- Os clientes veem um campo de entrada de valor na página de pagamento
4. Processamento do pagamento
Os clientes visitam o link de pagamento, revisam os detalhes pré-preenchidos e concluem a transação usando sua stablecoin preferida.5. Resposta da transação
O parâmetroreference da URL será incluído na resposta da transação e nos payloads dos webhooks, permitindo que você vincule os pagamentos aos seus sistemas internos.
Experimente
Conheça os links de pagamento do Blockradar com nossa demonstração ao vivo: 🔗 Link de pagamento de demonstração: https://pay.blockradar.co/demo Esta demonstração apresenta:- Fluxo de pagamento: Experiência completa do cliente, do link à conclusão
- UI/UX: Interface de pagamento moderna e intuitiva
- Opções de stablecoins: Vários métodos de pagamento e redes
- Atualizações em tempo real: Status e confirmações da transação ao vivo
O link de pagamento de demonstração é apenas para fins de teste. Nenhuma transação real
será processada.
Criação de links de pagamento
Link de pagamento básico
Crie um link de pagamento simples para um valor fixo:Link de pagamento com valor variável
Permita que os clientes escolham o valor do pagamento:Link de pagamento com upload de arquivo
Inclua um arquivo (por exemplo, fatura, imagem do produto) com seu link de pagamento usando form-data: Campos do form-data:name: Service Invoicedescription: Web development services - January 2024amount: 1500.00redirectUrl: https://company.example.com/payment-successsuccessMessage: Payment received! We’ll start working on your project.metadata: invoice_id: INV-2024-001, service: web_developmentfile: [cover.png] (upload de arquivo)
Ao incluir uploads de arquivos, use form-data em vez de JSON. O arquivo será
armazenado e ficará acessível pelo link de pagamento.
Parâmetros do link de pagamento
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
name | string (máx: 250) | O nome do link de pagamento |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
description | string (máx: 250) | Uma descrição do link de pagamento |
slug | string (máx: 250) | Um identificador único (URL-friendly). Deve corresponder à regex: ^[a-zA-Z0-9-]+$ |
amount | string | O valor do link de pagamento. Deve ser uma string numérica válida > 0 |
redirectUrl | string (URL) | A URL para redirecionar o usuário após o pagamento. Deve incluir http:// ou https:// |
successMessage | string (máx: 500) | Mensagem exibida quando o pagamento é bem-sucedido |
inactiveMessage | string (máx: 500) | Mensagem exibida quando o link de pagamento está inativo |
metadata | object (JSON string) | Metadata personalizada como pares chave-valor (string ou número). Deve ser enviada como JSON string em form-data |
paymentLimit | number (mín: 1) | Número máximo de pagamentos permitidos para este link |
file | file | Upload de arquivo opcional (por exemplo, imagem ou documento) anexado ao link de pagamento |
Fluxo de pagamento
Experiência do cliente
-
Clicar no link de pagamento
- O cliente recebe e clica no link de pagamento
- O link abre uma página de pagamento segura
-
Selecionar o método de pagamento
- Escolher entre as stablecoins disponíveis
- Selecionar a rede blockchain preferida
- Inserir o valor do pagamento (se variável)
-
Concluir o pagamento
- O cliente confirma os detalhes da transação
- O pagamento é processado na blockchain
- Confirmação e atualizações de status em tempo real
-
Confirmação de sucesso
- Página de confirmação de pagamento
- Redirecionamento opcional para seu site
- Recibo e detalhes da transação
Experiência do comerciante
-
Notificações em tempo real
- Eventos de webhook para o status do pagamento
- Notificações por e-mail (se configuradas)
- Atualizações no dashboard
-
Acompanhamento de pagamentos
- Histórico e status de transações
- Analytics e relatórios de pagamentos
- Integração com seus sistemas
Ciclo de vida do endereço
Eventos de webhook
Os links de pagamento disparam os seguintes eventos de webhook quando os pagamentos são recebidos:| Evento | Descrição |
|---|---|
deposit.success | Pagamento foi recebido pelo link de pagamento |
deposit.failed | A tentativa de pagamento falhou |
Exemplo de payload de webhook
Principais campos de dados do webhook
O payload do webhook inclui informações abrangentes sobre o pagamento:| Campo | Descrição |
|---|---|
reference | Referência personalizada dos parâmetros de query da URL (por exemplo, ORDER123, ID do cliente) |
paymentLink | Detalhes completos do link de pagamento, incluindo nome, descrição e metadata |
asset | Informações do ativo (USDC, USDT, etc.) com detalhes da rede |
blockchain | Informações da rede (Base, Ethereum, etc.) |
wallet | Detalhes e configurações da master wallet |
address | Endereço do cliente que recebeu o pagamento |
amlScreening | Resultados da triagem de antilavagem de dinheiro |
assetSwept | Status e detalhes do auto-sweep |
metadata | Dados personalizados do link de pagamento |
O campo
reference nos payloads dos webhooks corresponde ao parâmetro de query reference
que você inclui na URL de pagamento. Isso permite que você rastreie pagamentos
até pedidos, clientes ou referências internas específicas em seu sistema.Boas práticas
Segurança
- Use HTTPS para compartilhar todos os links de pagamento
- Monitore os eventos de webhook em busca de atividade suspeita
- Implemente rate limiting em seus endpoints de webhook
Experiência do usuário
- Descrições claras sobre a finalidade do pagamento
- Páginas de pagamento otimizadas para mobile
- Múltiplas opções de pagamento quando possível
Integração
- Armazene os IDs dos links de pagamento para rastreamento
- Use metadata para vincular pagamentos aos seus sistemas
- Implemente lógica de retry de webhooks para maior confiabilidade
- Teste os webhooks primeiro no ambiente sandbox
Casos de uso e exemplos
Loja de e-commerce
Fatura de serviço
Campanha de doação
Serviço por assinatura
Esses exemplos usam os parâmetros corretos da API de payment links do Blockradar. O
campo
metadata deve ser enviado como JSON string em form-data, e os uploads
de file são suportados para conteúdo adicional.Testes e desenvolvimento
Ambiente sandbox
- Use redes de testnet para desenvolvimento
- Teste a entrega e o tratamento de webhooks
- Verifique os fluxos de pagamento de ponta a ponta
- Teste casos extremos e cenários de erro
Testes de webhook
- Use ferramentas como webhook.site para testar
- Verifique a validação de assinaturas
- Teste os mecanismos de retry
- Monitore as taxas de entrega de webhooks
Plano de Checkout
O Blockradar Checkout é uma camada programável de pagamento em stablecoins para aceitar pagamentos onchain via links, QR codes incorporados e WalletConnect. Os fundos são liquidados diretamente em suas wallets não custodiais com suporte integrado para swap, bridge e roteamento de tesouraria.Preços
0,75% por transação
Preços simples e transparentes, sem custos de assinatura mensal.
Stablecoins suportadas
- USDC, USDT, cNGN, IDRX, EUROC e outras
Suporte multi-chain
- Ethereum, Polygon, Base, Solana, Tron, Celo e outras
Gestão de tesouraria
- Swap e Bridge: Converta e movimente ativos entre chains
- Auto-liquidação: Liquide automaticamente em sua moeda preferida
- Circle Gateway: Acesse o protocolo de transferência cross-chain da Circle
- Auto-sweeping: Consolide os fundos em sua master wallet
Este plano não inclui os recursos de Wallet-as-a-Service (WaaS) nem o
provisionamento de wallets dedicadas para seus usuários finais.
Obtendo as transações de um link de pagamento
Você pode recuperar todas as transações associadas a um link de pagamento específico usando o endpoint de transações dedicado. Isso é útil para:- Acompanhamento de pagamentos: Monitorar todos os pagamentos recebidos por um link específico
- Reconciliação: Combinar pagamentos a pedidos ou faturas
- Relatórios: Gerar relatórios para links de pagamento específicos
Parâmetros de query
| Parâmetro | Tipo | Descrição |
|---|---|---|
page | number | Número da página para paginação (padrão: 1) |
limit | number | Número de resultados por página (padrão: 10) |
status | string | Filtrar por status da transação (por exemplo, SUCCESS, PENDING, FAILED) |
type | string | Filtrar por tipo de transação (por exemplo, DEPOSIT) |
order | string | Ordem de classificação (ASC ou DESC) |
Exemplo de resposta
Suporte e recursos
Referência da API
- Criar link de pagamento
- Obter todos os links de pagamento
- Obter link de pagamento
- Atualizar link de pagamento
- Obter transações do link de pagamento
Obter ajuda
- E-mail: [email protected]
- Referência da API: Checkout
Checkout e links de pagamento são uma maneira poderosa de aceitar pagamentos em stablecoins com mínimo
esforço de integração. Comece com casos de uso simples e adicione complexidade
gradualmente, à medida que se familiariza com o sistema.

