Saltar para o conteúdo principal

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.

Pré-requisitos

Antes de criar links de pagamento, certifique-se de ter:
1

Chave de API

Obtenha sua chave de API no Dashboard do Blockradar. Acesse Developers para gerar uma.
2

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

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

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

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

Quando você cria um link de pagamento, o Blockradar retorna uma URL de pagamento exclusiva:
{
  "id": "pl_123456789",
  "name": "Product Purchase",
  "url": "https://pay.blockradar.co/payment-link-10012",
  "amount": "100.00",
  "currency": "USD",
  "active": true
}

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:
https://pay.blockradar.co/payment-link-10012?name=Customer&[email protected]&reference=ORDER123&amount=99.99&redirectUrl=https://yoursite.com/payment-success
Parâmetros de query opcionais suportados:
  • name - Nome do cliente (aparece na página de pagamento)
  • email - Endereço de e-mail do cliente
  • reference - Referência personalizada que será incluída nas respostas da transação
  • amount - 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 um redirectUrl é 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ção
  • reference - Sua referência personalizada (se fornecida)
  • slug - Identificador do link de pagamento
Exemplo de URL de redirecionamento:
https://yoursite.com/payment-success?status=success&tx_reference=tx_abc123&reference=ORDER123&slug=payment-link-10012
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 amount durante 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
Valor variável (entrada do cliente)
  • 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âmetro reference 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.
Crie um link de pagamento simples para um valor fixo:
{
  "name": "Product Purchase",
  "description": "Payment for Laptop Pro 2024",
  "amount": "100.00",
  "redirectUrl": "https://store.example.com/thank-you",
  "successMessage": "Thank you for your purchase!",
  "metadata": "{\"product_id\": \"prod_123\", \"order_id\": \"ord_456\"}"
}
Permita que os clientes escolham o valor do pagamento:
{
  "name": "Donation Campaign",
  "description": "Support our disaster relief efforts",
  "redirectUrl": "https://charity.example.com/thank-you",
  "successMessage": "Thank you for your generous donation!",
  "metadata": "{\"campaign\": \"disaster_relief_2024\"}"
}
Inclua um arquivo (por exemplo, fatura, imagem do produto) com seu link de pagamento usando form-data: Campos do form-data:
  • name: Service Invoice
  • description: Web development services - January 2024
  • amount: 1500.00
  • redirectUrl: https://company.example.com/payment-success
  • successMessage: Payment received! We’ll start working on your project.
  • metadata: invoice_id: INV-2024-001, service: web_development
  • file: [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 obrigatórios

ParâmetroTipoDescrição
namestring (máx: 250)O nome do link de pagamento

Parâmetros opcionais

ParâmetroTipoDescrição
descriptionstring (máx: 250)Uma descrição do link de pagamento
slugstring (máx: 250)Um identificador único (URL-friendly). Deve corresponder à regex: ^[a-zA-Z0-9-]+$
amountstringO valor do link de pagamento. Deve ser uma string numérica válida > 0
redirectUrlstring (URL)A URL para redirecionar o usuário após o pagamento. Deve incluir http:// ou https://
successMessagestring (máx: 500)Mensagem exibida quando o pagamento é bem-sucedido
inactiveMessagestring (máx: 500)Mensagem exibida quando o link de pagamento está inativo
metadataobject (JSON string)Metadata personalizada como pares chave-valor (string ou número). Deve ser enviada como JSON string em form-data
paymentLimitnumber (mín: 1)Número máximo de pagamentos permitidos para este link
filefileUpload de arquivo opcional (por exemplo, imagem ou documento) anexado ao link de pagamento

Fluxo de pagamento

Experiência do cliente

  1. Clicar no link de pagamento
    • O cliente recebe e clica no link de pagamento
    • O link abre uma página de pagamento segura
  2. 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)
  3. 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
  4. 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

  1. Notificações em tempo real
    • Eventos de webhook para o status do pagamento
    • Notificações por e-mail (se configuradas)
    • Atualizações no dashboard
  2. 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

Os endereços de pagamento gerados para links de checkout têm um ciclo de vida limitado:
  • Após um pagamento bem-sucedido: O endereço é desativado imediatamente e não pode receber pagamentos adicionais
  • Após 24 horas de inatividade: Se nenhum pagamento for feito a um endereço dentro de 24 horas, ele é automaticamente desativado
Cada nova sessão de pagamento gera um novo endereço. Isso garante segurança e evita a reutilização de endereços.

Eventos de webhook

Os links de pagamento disparam os seguintes eventos de webhook quando os pagamentos são recebidos:
EventoDescrição
deposit.successPagamento foi recebido pelo link de pagamento
deposit.failedA tentativa de pagamento falhou

Exemplo de payload de webhook

{
  "event": "deposit.success",
  "data": {
    "id": "0d7a0b98-943c-48d0-8baa-216c29956050",
    "reference": "bjXPk7d00",
    "senderAddress": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
    "recipientAddress": "0x9D8dF15628B737CAf63a92Abd8E8bb304210eA94",
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1",
    "amountPaid": "1",
    "amountUSD": "1",
    "rateUSD": "1",
    "fee": null,
    "feeHash": null,
    "currency": "USD",
    "toCurrency": null,
    "blockNumber": 34771099,
    "blockHash": "0xa9dc060dbe649676a15ae1faee725851fe1ecf2401b200e60fff33fc0ff41e84",
    "hash": "0x9f01af8f517afb3fd3ee17f36dabee03a4d6514885473115815de86c28ea7dfb",
    "confirmations": 6,
    "confirmed": true,
    "gasPrice": "7026436",
    "gasUsed": "62159",
    "gasFee": "0.000000436756235324",
    "status": "SUCCESS",
    "type": "DEPOSIT",
    "note": null,
    "amlScreening": {
      "provider": "ofac, fbi, tether, circle",
      "status": "success",
      "message": "Address is not sanctioned"
    },
    "assetSwept": true,
    "assetSweptAt": "2025-08-27T21:53:22.300Z",
    "assetSweptGasFee": "0.000000489848406004",
    "assetSweptHash": "0xe85efcf15ff8eaa2429aea32515347d65ff8098f22dac567611c258441bde809",
    "assetSweptSenderAddress": "0x9D8dF15628B737CAf63a92Abd8E8bb304210eA94",
    "assetSweptRecipientAddress": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43",
    "assetSweptAmount": "1",
    "reason": "Funds swept successfully",
    "network": "mainnet",
    "chainId": 8453,
    "metadata": {},
    "toAmount": null,
    "signedTransaction": null,
    "rate": null,
    "createdAt": "2025-08-27T21:52:19.839Z",
    "updatedAt": "2025-08-27T21:53:22.303Z",
    "asset": {
      "id": "3a18a31a-86ad-44a0-9b9c-cdb69d535c64",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "standard": null,
      "currency": "USD",
      "isActive": true,
      "logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
      "network": "mainnet",
      "isNative": false,
      "createdAt": "2024-06-08T12:59:11.303Z",
      "updatedAt": "2025-06-03T11:34:36.288Z"
    },
    "address": {
      "id": "824d8ff9-1ee4-43d1-bec0-c77f25699cd6",
      "address": "0x9D8dF15628B737CAf63a92Abd8E8bb304210eA94",
      "name": null,
      "isActive": true,
      "type": "INTERNAL",
      "derivationPath": "m/44'/60'/0'/0/503",
      "metadata": null,
      "configurations": {
        "aml": {
          "status": "success",
          "message": "Address is not sanctioned",
          "provider": "ofac, fbi, tether, circle"
        }
      },
      "network": "mainnet",
      "createdAt": "2025-08-27T21:52:19.839Z",
      "updatedAt": "2025-08-27T21:52:19.839Z"
    },
    "blockchain": {
      "id": "28a730d3-211b-40f7-bb8f-dd589dcc738e",
      "name": "base",
      "symbol": "eth",
      "slug": "base",
      "derivationPath": "m/44'/60'/0'/0",
      "isEvmCompatible": true,
      "isL2": true,
      "logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/Base_Network_Logo_vqyh7r.png",
      "isActive": true,
      "tokenStandard": null,
      "createdAt": "2024-06-07T11:09:56.586Z",
      "updatedAt": "2025-11-26T15:26:21.825Z"
    },
    "wallet": {
      "id": "6b741fbc-8a9c-48a1-92b0-ae7b52de8b9e",
      "name": "Base Mainnet Wallet",
      "description": "This is base mainnet wallet",
      "address": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43",
      "derivationPath": "m/44'/60'/0'/0/0",
      "isActive": true,
      "status": "ACTIVE",
      "network": "mainnet",
      "configurations": {
        "withdrawal": {
          "gasless": {
            "isActive": true
          }
        },
        "autoSweeping": {
          "isActive": true
        }
      },
      "createdAt": "2024-06-15T02:53:23.409Z",
      "updatedAt": "2025-08-18T23:26:13.469Z",
      "business": {
        "id": "a109729b-3b97-4fb3-a90a-769a0cbf6a25",
        "name": "Blockradar",
        "sector": "infrastructure",
        "userId": "831b739e-ed85-499a-b273-8a1a5b41b7a0",
        "status": "ACTIVE",
        "pipedriveOrganizationId": "308",
        "createdAt": "2023-04-28T17:40:18.541Z",
        "updatedAt": "2025-06-19T23:51:01.019Z"
      }
    },
    "beneficiary": null,
    "paymentLink": {
      "id": "dd8eb830-0971-4f61-97bc-b1ad352e1c48",
      "name": "Blockradar Checkout Demo",
      "description": "Blockradar payment links simplify stablecoin transactions into a clean, intuitive experience. This demo shows how users can pay securely using stablecoins with just a few clicks, fast, transparent, and onchain.",
      "slug": "demo",
      "amount": null,
      "currency": "USD",
      "imageUrl": "https://res.cloudinary.com/blockradar/image/upload/v1752049884/payment-links/ndlbgyb5wg70bpr3p1uu.png",
      "redirectUrl": null,
      "successMessage": null,
      "active": true,
      "inactiveMessage": null,
      "network": "mainnet",
      "type": "payment",
      "createdChannel": "dashboard",
      "metadata": {},
      "configurations": {},
      "createdAt": "2024-06-20T05:38:13.863Z",
      "updatedAt": "2025-07-09T08:31:25.328Z"
    },
    "toAsset": null,
    "toBlockchain": null,
    "toWallet": null
  }
}

Principais campos de dados do webhook

O payload do webhook inclui informações abrangentes sobre o pagamento:
CampoDescrição
referenceReferência personalizada dos parâmetros de query da URL (por exemplo, ORDER123, ID do cliente)
paymentLinkDetalhes completos do link de pagamento, incluindo nome, descrição e metadata
assetInformações do ativo (USDC, USDT, etc.) com detalhes da rede
blockchainInformações da rede (Base, Ethereum, etc.)
walletDetalhes e configurações da master wallet
addressEndereço do cliente que recebeu o pagamento
amlScreeningResultados da triagem de antilavagem de dinheiro
assetSweptStatus e detalhes do auto-sweep
metadataDados 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

{
  "name": "Laptop Pro 2024",
  "description": "High-performance laptop with latest specifications",
  "amount": "299.99",
  "redirectUrl": "https://store.example.com/thank-you",
  "successMessage": "Thank you for your purchase! Your order has been confirmed.",
  "metadata": "{\"product_id\": \"laptop_pro_2024\", \"category\": \"electronics\", \"customer_email\": \"[email protected]\"}",
  "paymentLimit": 1
}

Fatura de serviço

{
  "name": "Web Development Services",
  "description": "Professional web development services - January 2024",
  "amount": "1500.00",
  "redirectUrl": "https://company.example.com/payment-success",
  "successMessage": "Payment received! We'll start working on your project immediately.",
  "metadata": "{\"invoice_id\": \"INV-2024-001\", \"service\": \"web_development\", \"client_id\": \"client_789\"}",
  "paymentLimit": 1
}

Campanha de doação

{
  "name": "Disaster Relief 2024",
  "description": "Support our disaster relief efforts in affected regions",
  "amount": "10.00",
  "redirectUrl": "https://charity.example.com/thank-you",
  "successMessage": "Thank you for your generous donation! Every contribution makes a difference.",
  "metadata": "{\"campaign\": \"disaster_relief_2024\", \"organization\": \"charity_foundation\", \"tax_deductible\": true}",
  "paymentLimit": 1000
}

Serviço por assinatura

{
  "name": "Premium Plan Monthly",
  "description": "Monthly subscription to our premium service",
  "amount": "29.99",
  "redirectUrl": "https://service.example.com/welcome",
  "successMessage": "Welcome to Premium! Your subscription is now active.",
  "metadata": "{\"plan\": \"premium_monthly\", \"billing_cycle\": \"monthly\", \"features\": \"unlimited_access\"}",
  "paymentLimit": 100
}
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.
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âmetroTipoDescrição
pagenumberNúmero da página para paginação (padrão: 1)
limitnumberNúmero de resultados por página (padrão: 10)
statusstringFiltrar por status da transação (por exemplo, SUCCESS, PENDING, FAILED)
typestringFiltrar por tipo de transação (por exemplo, DEPOSIT)
orderstringOrdem de classificação (ASC ou DESC)

Exemplo de resposta

{
  "status": true,
  "message": "Transactions fetched successfully",
  "data": [
    {
      "id": "0d7a0b98-943c-48d0-8baa-216c29956050",
      "reference": "bjXPk7d00",
      "amount": "100.00",
      "amountUSD": "100.00",
      "status": "SUCCESS",
      "type": "DEPOSIT",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "asset": {
        "symbol": "USDC",
        "name": "USD Coin"
      },
      "blockchain": {
        "name": "base",
        "slug": "base"
      },
      "customer": {
        "email": "[email protected]",
        "name": "John Doe"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 25,
    "totalPages": 3
  }
}

Suporte e recursos

Referência da API

Obter ajuda

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.