Links de Pagamento - Blockradar

Links de pagamento fornecem uma maneira simples de aceitar pagamentos em stablecoin sem exigir que os clientes tenham uma conta Blockradar ou integrem diretamente com sua aplicação.

Introdução

Links de pagamento são URLs compartilháveis que permitem que qualquer pessoa envie pagamentos em stablecoin para sua carteira. Eles são perfeitos para:

E-commerce: Envie para clientes para compras de produtos
Faturamento: Inclua em faturas por serviços prestados
Doações: Compartilhe em mídias sociais ou sites
Pagamentos de marketplace: Facilite transações peer-to-peer
Cobrança de assinaturas: Cobrança 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, mensagem ou incorpore-a em seu site.

Pagamento

Os clientes clicam no link, inserem seus detalhes de pagamento e concluem a transação.

Confirmação

Você recebe notificações de 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 metadados
URLs Compartilháveis: Gere links de pagamento exclusivos para cada transação
Pré-preenchimento de Cliente: Pré-popule detalhes do cliente via parâmetros de consulta da URL
Rastreamento em Tempo Real: Monitore o status do pagamento e receba notificações de webhook
Suporte Multi-rede: Aceite pagamentos em diferentes redes blockchain
Integração de Auto-sweep: Fundos consolidados automaticamente na carteira principal

Suporte Multi-Ativos

USDT, USDC, DAI, BUSD em múltiplas blockchains
Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Tron, Solana, Celo
Conversão e roteamento automáticos para 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 oportunos
Metadados personalizados para rastreamento e análises
Notificações de webhook para atualizações em tempo real

Segurança e Conformidade

Triagem AML em todos os pagamentos recebidos
Validação de endereço e verificação
Detecção de fraude e prevenção
Conformidade regulatória 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:

{
  "id": "pl_123456789",
  "name": "Compra de Produto",
  "url": "https://pay.blockradar.co/payment-link-10012",
  "amount": "100.00",
  "currency": "USD",
  "active": true
}

2. Pré-preenchimento de Cliente com Parâmetros de Consulta

Você pode aprimorar a URL de pagamento com parâmetros de consulta para pré-preencher automaticamente os detalhes do cliente na página de pagamento:

https://pay.blockradar.co/payment-link-10012?name=Cliente&[email protected]&reference=PEDIDO123&amount=99.99&redirectUrl=https://seusite.com/pagamento-sucesso

Parâmetros de Consulta 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 de transação
amount - Pré-preencha o valor do pagamento (substitui o valor padrão do link se definido)
redirectUrl - URL para redirecionar após a conclusão do pagamento

3. Redirecionamento Pós-Pagamento

Quando uma redirectUrl é fornecida, os clientes serão automaticamente redirecionados para sua URL especificada após a conclusão do processamento do pagamento. A URL de redirecionamento incluirá os seguintes parâmetros de consulta: Parâmetros de Consulta de 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://seusite.com/pagamento-sucesso?status=success&tx_reference=tx_abc123&reference=PEDIDO123&slug=payment-link-10012

O redirecionamento ocorre apenas após a conclusão do processamento do pagamento. Se nenhuma redirectUrl for fornecida, os clientes verão a página de conclusão de pagamento padrão.

4. Configuração de Valor

Links de pagamento suportam dois modos de valor: Valor Fixo (Pré-definido)

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ços definidos
Exemplo: Compra de produto por exatamente $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 de 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 nas cargas úteis do webhook, permitindo que você vincule pagamentos de volta aos seus sistemas internos.

Experimente

Experimente os links de pagamento Blockradar em primeira mão 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 até a conclusão
UI/UX: Interface de pagamento moderna e intuitiva
Opções de Stablecoin: Múltiplos métodos de pagamento e redes
Atualizações em Tempo Real: Status de transação ao vivo e confirmações

O link de pagamento de demonstração é apenas para fins de teste. Nenhuma transação real será processada.

Criando Links de Pagamento

Link de Pagamento Básico

Crie um link de pagamento simples para um valor fixo:

{
  "name": "Compra de Produto",
  "description": "Pagamento por Laptop Pro 2024",
  "amount": "100.00",
  "redirectUrl": "https://loja.exemplo.com/obrigado",
  "successMessage": "Obrigado pela sua compra!",
  "metadata": "{\"product_id\": \"prod_123\", \"order_id\": \"ord_456\"}"
}

Link de Pagamento de Valor Variável

Permita que os clientes escolham seu valor de pagamento:

{
  "name": "Campanha de Doação",
  "description": "Apoie nossos esforços de socorro em desastres",
  "redirectUrl": "https://caridade.exemplo.com/obrigado",
  "successMessage": "Obrigado pela sua generosa doação!",
  "metadata": "{\"campaign\": \"disaster_relief_2024\"}"
}

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 de Form Data:

name: Fatura de Serviço
description: Serviços de desenvolvimento web - Janeiro 2024
amount: 1500.00
redirectUrl: https://empresa.exemplo.com/pagamento-sucesso
successMessage: Pagamento recebido! Começaremos a trabalhar em seu projeto.
metadata: invoice_id: INV-2024-001, service: web_development
file: [capa.png] (upload de arquivo)

Ao incluir uploads de arquivo, use form-data em vez de JSON. O arquivo será armazenado e acessível via link de pagamento.

Parâmetros do Link de Pagamento

Parâmetros Obrigatórios

Parâmetro	Tipo	Descrição
`name`	string (max: 250)	O nome do link de pagamento

Parâmetros Opcionais

Parâmetro	Tipo	Descrição
`description`	string (max: 250)	Uma descrição do link de pagamento
`slug`	string (max: 250)	Um identificador exclusivo (compatível com URL). Deve corresponder à regex: `^[a-zA-Z0-9-]+$`
`amount`	string	O valor do link de pagamento. Deve ser um número de string válido > 0
`redirectUrl`	string (URL)	A URL para redirecionar o usuário após o pagamento. Deve incluir http:// ou https://
`successMessage`	string (max: 500)	Mensagem mostrada quando o pagamento for bem-sucedido
`inactiveMessage`	string (max: 500)	Mensagem mostrada quando o link de pagamento está inativo
`metadata`	object (JSON string)	Metadados personalizados como pares chave-valor (string ou número). Deve ser enviado como string JSON em form-data
`paymentLimit`	number (min: 1)	Número máximo de pagamentos permitidos para este link
`file`	file	Um upload de arquivo opcional (por exemplo, imagem ou documento) anexado ao link de pagamento

Fluxo de Pagamento

Experiência do Cliente

Clique no Link de Pagamento
- Cliente recebe e clica no link de pagamento
- O link abre em uma página de pagamento segura
Selecione o Método de Pagamento
- Escolha entre stablecoins disponíveis
- Selecione a rede blockchain preferida
- Insira o valor do pagamento (se variável)
Complete o Pagamento
- Cliente confirma os detalhes da transação
- O pagamento é processado na blockchain
- Confirmação em tempo real e atualizações de status
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 status do pagamento
- Notificações por e-mail (se configuradas)
- Atualizações do painel
Rastreamento de Pagamentos
- Histórico de transações e status
- Análises e relatórios de pagamentos
- Integração com seus sistemas

Eventos de Webhook

Links de pagamento acionam os seguintes eventos de webhook quando os pagamentos são recebidos:

Evento	Descrição
`deposit.success`	Pagamento foi recebido via link de pagamento
`deposit.failed`	Tentativa de pagamento falhou

Exemplo de Carga Útil 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
  }
}

Campos Principais de Dados do Webhook

A carga útil do webhook inclui informações abrangentes sobre o pagamento:

Campo	Descrição
`reference`	Referência personalizada dos parâmetros de consulta da URL (por exemplo, ORDER123, ID do cliente)
`paymentLink`	Detalhes completos do link de pagamento incluindo nome, descrição e metadados
`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 carteira principal
`address`	Endereço do cliente que recebeu o pagamento
`amlScreening`	Resultados da triagem anti-lavagem de dinheiro
`assetSwept`	Status e detalhes do auto-sweep
`metadata`	Dados personalizados do link de pagamento

O campo reference nas cargas úteis do webhook corresponde ao parâmetro de consulta reference que você inclui na URL de pagamento. Isso permite que você rastreie pagamentos de volta a pedidos específicos, clientes ou referências internas em seu sistema.

Melhores Práticas

Segurança

Use HTTPS para todo compartilhamento de link de pagamento
Monitore eventos de webhook para atividades suspeitas
Implemente limitação de taxa em seus endpoints de webhook

Experiência do Usuário

Descrições claras do que é o pagamento
Páginas de pagamento otimizadas para dispositivos móveis
Múltiplas opções de pagamento quando possível

Integração

Armazene IDs de links de pagamento para rastreamento
Use metadados para vincular pagamentos aos seus sistemas
Implemente lógica de repetição de webhook para confiabilidade
Teste webhooks no ambiente sandbox primeiro

Casos de Uso e Exemplos

Loja de E-commerce

{
  "name": "Laptop Pro 2024",
  "description": "Laptop de alto desempenho com especificações mais recentes",
  "amount": "299.99",
  "redirectUrl": "https://loja.exemplo.com/obrigado",
  "successMessage": "Obrigado pela sua compra! Seu pedido foi confirmado.",
  "metadata": "{\"product_id\": \"laptop_pro_2024\", \"category\": \"electronics\", \"customer_email\": \"[email protected]\"}",
  "paymentLimit": 1
}

Fatura de Serviço

{
  "name": "Serviços de Desenvolvimento Web",
  "description": "Serviços profissionais de desenvolvimento web - Janeiro 2024",
  "amount": "1500.00",
  "redirectUrl": "https://empresa.exemplo.com/pagamento-sucesso",
  "successMessage": "Pagamento recebido! Começaremos a trabalhar em seu projeto imediatamente.",
  "metadata": "{\"invoice_id\": \"INV-2024-001\", \"service\": \"web_development\", \"client_id\": \"client_789\"}",
  "paymentLimit": 1
}

Campanha de Doação

{
  "name": "Socorro em Desastres 2024",
  "description": "Apoie nossos esforços de socorro em desastres nas regiões afetadas",
  "amount": "10.00",
  "redirectUrl": "https://caridade.exemplo.com/obrigado",
  "successMessage": "Obrigado pela sua generosa doação! Cada contribuição faz a diferença.",
  "metadata": "{\"campaign\": \"disaster_relief_2024\", \"organization\": \"charity_foundation\", \"tax_deductible\": true}",
  "paymentLimit": 1000
}

Serviço de Assinatura

{
  "name": "Plano Premium Mensal",
  "description": "Assinatura mensal do nosso serviço premium",
  "amount": "29.99",
  "redirectUrl": "https://servico.exemplo.com/boas-vindas",
  "successMessage": "Bem-vindo ao Premium! Sua assinatura agora está ativa.",
  "metadata": "{\"plan\": \"premium_monthly\", \"billing_cycle\": \"monthly\", \"features\": \"unlimited_access\"}",
  "paymentLimit": 100
}

Estes exemplos usam os parâmetros corretos da API de links de pagamento do Blockradar. O campo metadata deve ser enviado como uma string JSON em form-data, e uploads de file são suportados para conteúdo adicional.

Teste e Desenvolvimento

Ambiente Sandbox

Use redes testnet para desenvolvimento
Teste a entrega e manipulação de webhooks
Verifique os fluxos de pagamento de ponta a ponta
Teste casos extremos e cenários de erro

Teste de Webhook

Use ferramentas como webhook.site para testes
Verifique a validação de assinatura
Teste mecanismos de repetição
Monitore taxas de entrega de webhook

Suporte e Recursos

Referência da API

Obtendo Ajuda

E-mail: [email protected]
Referência da API: Links de Pagamento

Links de pagamento são uma maneira poderosa de aceitar pagamentos em stablecoin com esforço mínimo de integração. Comece com casos de uso simples e adicione complexidade gradualmente à medida que você se familiariza com o sistema.

Começar

Essenciais

​Introdução

​Como Funcionam os Links de Pagamento

Criação

Compartilhamento

Pagamento

Confirmação

​Recursos dos Links de Pagamento

​Suporte Multi-Ativos

​Configuração Flexível

​Segurança e Conformidade

​Fluxo de Pagamento

​1. Criação do Link de Pagamento

​2. Pré-preenchimento de Cliente com Parâmetros de Consulta

​3. Redirecionamento Pós-Pagamento

​4. Configuração de Valor

​4. Processamento de Pagamento

​5. Resposta da Transação

​Experimente

​Criando Links de Pagamento

​Link de Pagamento Básico

​Link de Pagamento de Valor Variável

​Link de Pagamento com Upload de Arquivo

​Parâmetros do Link de Pagamento

​Parâmetros Obrigatórios

​Parâmetros Opcionais

​Fluxo de Pagamento

​Experiência do Cliente

​Experiência do Comerciante

​Eventos de Webhook

​Exemplo de Carga Útil de Webhook

​Campos Principais de Dados do Webhook

​Melhores Práticas

​Segurança

​Experiência do Usuário

​Integração

​Casos de Uso e Exemplos

​Loja de E-commerce

​Fatura de Serviço

​Campanha de Doação

​Serviço de Assinatura

​Teste e Desenvolvimento

​Ambiente Sandbox

​Teste de Webhook

​Suporte e Recursos

​Referência da API

​Obtendo Ajuda

Introdução

Como Funcionam os Links de Pagamento

Recursos dos Links de Pagamento

Suporte Multi-Ativos

Configuração Flexível

Segurança e Conformidade

Fluxo de Pagamento

1. Criação do Link de Pagamento

2. Pré-preenchimento de Cliente com Parâmetros de Consulta

3. Redirecionamento Pós-Pagamento

4. Configuração de Valor

4. Processamento de Pagamento

5. Resposta da Transação

Experimente

Criando Links de Pagamento

Link de Pagamento Básico

Link de Pagamento de Valor Variável

Link de Pagamento com Upload de Arquivo

Parâmetros do Link de Pagamento

Parâmetros Obrigatórios

Parâmetros Opcionais

Fluxo de Pagamento

Experiência do Cliente

Experiência do Comerciante

Eventos de Webhook

Exemplo de Carga Útil de Webhook

Campos Principais de Dados do Webhook

Melhores Práticas

Segurança

Experiência do Usuário

Integração

Casos de Uso e Exemplos

Loja de E-commerce

Fatura de Serviço

Campanha de Doação

Serviço de Assinatura

Teste e Desenvolvimento

Ambiente Sandbox

Teste de Webhook

Suporte e Recursos

Referência da API

Obtendo Ajuda