Saltar al contenido 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.

En resumen
Blockradar Checkout le permite aceptar pagos en stablecoins mediante enlaces compartibles, sin necesidad de cuentas de cliente ni integraciones complejas. Cree un enlace, compártalo y reciba pagos directamente en su wallet.

Requisitos previos

Antes de crear enlaces de pago, asegúrese de contar con:
1

Clave API

Obtenga su clave API desde el Dashboard de Blockradar. Vaya a Developers para generar una.
2

Master Wallet creada

Cree una master wallet mediante la API Create Wallet o desde el dashboard. Los enlaces de pago están vinculados a una wallet.
3

Plan de Checkout activo

Asegúrese de que la función Checkout esté habilitada en su cuenta. Contacte a [email protected] si necesita activarla.
4

Webhook configurado (opcional)

Configure webhooks para recibir notificaciones de pago en tiempo real. Consulte Webhooks para más detalles.

Introducción

Los enlaces de pago son URLs compartibles que permiten a cualquier persona enviar pagos en stablecoins a su wallet. Son ideales para:
  • E-commerce: Enviar a clientes para la compra de productos
  • Facturación: Incluir en facturas por servicios prestados
  • Donaciones: Compartir en redes sociales o sitios web
  • Pagos en marketplaces: Facilitar transacciones peer-to-peer
  • Cobros por suscripción: Recolección de pagos recurrentes

Cómo funcionan los enlaces de pago

Creación

Cree un enlace de pago con parámetros específicos como el monto, el nombre, la descripción y los límites de pago.

Compartir

Comparta la URL generada con sus clientes por correo electrónico, mensajería o incrústela en su sitio web.

Pago

Los clientes hacen clic en el enlace, ingresan sus datos de pago y completan la transacción.

Confirmación

Usted recibe notificaciones por webhook y puede rastrear el estado del pago en tiempo real.

Funcionalidades de los enlaces de pago

  • Parámetros personalizables: Defina monto, descripción, límites de pago y metadata
  • URLs compartibles: Genere enlaces de pago únicos para cada transacción
  • Pre-llenado del cliente: Pre-rellene los datos del cliente mediante parámetros de query en la URL
  • Seguimiento en tiempo real: Monitoree el estado del pago y reciba notificaciones por webhook
  • Soporte multi-red: Acepte pagos en distintas redes blockchain
  • Integración con auto-sweep: Los fondos se consolidan automáticamente en la master wallet

Soporte multi-activo

  • USDT, USDC, DAI, BUSD en múltiples blockchains
  • Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Tron, Solana, Celo
  • Conversión y enrutamiento automático para una experiencia óptima del usuario

Configuración flexible

  • Montos fijos para productos/servicios específicos
  • Montos variables para donaciones o pagos personalizados
  • Límites de pago para garantizar pagos puntuales
  • Metadata personalizada para seguimiento y analítica
  • Notificaciones por webhook para actualizaciones en tiempo real

Seguridad y cumplimiento

  • Screening AML en todos los pagos entrantes
  • Validación y verificación de direcciones
  • Detección y prevención de fraudes
  • Cumplimiento regulatorio en distintas jurisdicciones

Flujo de pago

1. Creación del enlace de pago

Cuando crea un enlace de pago, Blockradar devuelve una URL de pago única:
{
  "id": "pl_123456789",
  "name": "Product Purchase",
  "url": "https://pay.blockradar.co/payment-link-10012",
  "amount": "100.00",
  "currency": "USD",
  "active": true
}

2. Pre-llenado del cliente con parámetros de query

Puede mejorar la URL de pago con parámetros de query para pre-rellenar automáticamente los datos del cliente en la página de pago:
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 opcionales soportados:
  • name - Nombre del cliente (aparece en la página de pago)
  • email - Correo electrónico del cliente
  • reference - Referencia personalizada que se incluirá en las respuestas de transacción
  • amount - Pre-rellena el monto del pago (anula el monto predeterminado del enlace si está definido)
  • redirectUrl - URL a la que redirigir después de completar el pago

3. Redirección posterior al pago

Cuando se proporciona un redirectUrl, los clientes serán redirigidos automáticamente a la URL especificada después de que se complete el procesamiento del pago. La URL de redirección incluirá los siguientes parámetros de query: Parámetros de query de la redirección:
  • status - Estado del pago (success, failed, pending)
  • tx_reference - ID de referencia de la transacción
  • reference - Su referencia personalizada (si se proporcionó)
  • slug - Identificador del enlace de pago
Ejemplo de URL de redirección:
https://yoursite.com/payment-success?status=success&tx_reference=tx_abc123&reference=ORDER123&slug=payment-link-10012
La redirección sólo se produce después de que se complete el procesamiento del pago. Si no se proporciona un redirectUrl, los clientes verán la página de finalización de pago predeterminada.

4. Configuración del monto

Los enlaces de pago admiten dos modos de monto: Monto fijo (preestablecido)
  • Cuando especifica un amount durante la creación, los clientes no pueden modificar el monto del pago
  • Ideal para productos o servicios específicos con precios establecidos
  • Ejemplo: Compra de un producto por exactamente 99.99 USD
Monto variable (entrada del cliente)
  • Cuando no se especifica amount, los clientes pueden ingresar su propio monto de pago
  • Perfecto para donaciones, propinas o escenarios de precios flexibles
  • Los clientes ven un campo de entrada de monto en la página de pago

4. Procesamiento del pago

Los clientes visitan el enlace de pago, revisan los datos pre-rellenados y completan la transacción usando su stablecoin preferida.

5. Respuesta de la transacción

El parámetro reference de la URL se incluirá en la respuesta de la transacción y en las cargas útiles de los webhooks, lo que le permite vincular los pagos con sus sistemas internos.

Pruébelo

Experimente los enlaces de pago de Blockradar con nuestra demo en vivo: 🔗 Enlace de pago demo: https://pay.blockradar.co/demo Esta demo muestra:
  • Flujo de pago: Experiencia completa del cliente desde el enlace hasta la finalización
  • UI/UX: Interfaz de pago moderna e intuitiva
  • Opciones de stablecoins: Múltiples métodos de pago y redes
  • Actualizaciones en tiempo real: Estado y confirmaciones de la transacción en vivo
El enlace de pago demo es sólo para fines de prueba. No se procesarán transacciones reales.

Creación de enlaces de pago

Enlace de pago básico

Cree un enlace de pago simple para un monto fijo:
{
  "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\"}"
}

Enlace de pago con monto variable

Permita que los clientes elijan el monto de su pago:
{
  "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\"}"
}

Enlace de pago con carga de archivo

Incluya un archivo (por ejemplo, factura, imagen del producto) con su enlace de pago usando form-data: Campos de 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] (carga de archivo)
Cuando incluya cargas de archivos, use form-data en lugar de JSON. El archivo se almacenará y será accesible mediante el enlace de pago.

Parámetros del enlace de pago

Parámetros requeridos

ParámetroTipoDescripción
namestring (máx: 250)El nombre del enlace de pago

Parámetros opcionales

ParámetroTipoDescripción
descriptionstring (máx: 250)Una descripción del enlace de pago
slugstring (máx: 250)Un identificador único (apto para URL). Debe coincidir con la regex: ^[a-zA-Z0-9-]+$
amountstringEl monto del enlace de pago. Debe ser un número en string válido > 0
redirectUrlstring (URL)La URL a la que redirigir al usuario después del pago. Debe incluir http:// o https://
successMessagestring (máx: 500)Mensaje mostrado cuando el pago se realiza con éxito
inactiveMessagestring (máx: 500)Mensaje mostrado cuando el enlace de pago está inactivo
metadataobject (JSON string)Metadata personalizada como pares clave-valor (string o número). Debe enviarse como JSON string en form-data
paymentLimitnumber (mín: 1)Número máximo de pagos permitidos para este enlace
filefileUna carga de archivo opcional (por ejemplo, imagen o documento) adjunta al enlace de pago

Flujo de pago

Experiencia del cliente

  1. Hacer clic en el enlace de pago
    • El cliente recibe y hace clic en el enlace de pago
    • El enlace abre una página de pago segura
  2. Seleccionar el método de pago
    • Elegir entre las stablecoins disponibles
    • Seleccionar la red blockchain preferida
    • Ingresar el monto del pago (si es variable)
  3. Completar el pago
    • El cliente confirma los detalles de la transacción
    • El pago se procesa en la blockchain
    • Confirmación y actualizaciones de estado en tiempo real
  4. Confirmación de éxito
    • Página de confirmación de pago
    • Redirección opcional a su sitio web
    • Recibo y detalles de la transacción

Experiencia del comerciante

  1. Notificaciones en tiempo real
    • Eventos de webhook para el estado del pago
    • Notificaciones por correo electrónico (si está configurado)
    • Actualizaciones del dashboard
  2. Seguimiento de pagos
    • Historial y estado de transacciones
    • Analítica e informes de pagos
    • Integración con sus sistemas

Ciclo de vida de la dirección

Las direcciones de pago generadas para los enlaces de checkout tienen un ciclo de vida limitado:
  • Después de un pago exitoso: La dirección se desactiva inmediatamente y no puede recibir pagos adicionales
  • Después de 24 horas de inactividad: Si no se realiza un pago a una dirección dentro de 24 horas, se desactiva automáticamente
Cada nueva sesión de pago genera una dirección nueva. Esto garantiza la seguridad y evita la reutilización de direcciones.

Eventos de webhook

Los enlaces de pago activan los siguientes eventos de webhook cuando se reciben pagos:
EventoDescripción
deposit.successSe recibió un pago a través del enlace de pago
deposit.failedEl intento de pago falló

Ejemplo 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 clave de los datos de webhook

La carga útil del webhook incluye información completa sobre el pago:
CampoDescripción
referenceReferencia personalizada de los parámetros de query de la URL (p. ej., ORDER123, ID de cliente)
paymentLinkDetalles completos del enlace de pago, incluidos nombre, descripción y metadata
assetInformación del activo (USDC, USDT, etc.) con detalles de la red
blockchainInformación de la red (Base, Ethereum, etc.)
walletDetalles y configuraciones de la master wallet
addressDirección del cliente que recibió el pago
amlScreeningResultados del screening contra lavado de dinero
assetSweptEstado y detalles del auto-sweep
metadataDatos personalizados del enlace de pago
El campo reference en las cargas útiles de webhook corresponde al parámetro de query reference que incluye en la URL de pago. Esto le permite rastrear los pagos hasta órdenes específicas, clientes o referencias internas en su sistema.

Buenas prácticas

Seguridad

  • Use HTTPS para compartir todos los enlaces de pago
  • Monitoree los eventos de webhook ante actividad sospechosa
  • Implemente rate limiting en sus endpoints de webhook

Experiencia del usuario

  • Descripciones claras de para qué es el pago
  • Páginas de pago optimizadas para móvil
  • Múltiples opciones de pago cuando sea posible

Integración

  • Almacene los IDs de los enlaces de pago para seguimiento
  • Use metadata para vincular los pagos con sus sistemas
  • Implemente lógica de reintento de webhooks para mayor confiabilidad
  • Pruebe los webhooks primero en el entorno sandbox

Casos de uso y ejemplos

Tienda 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
}

Factura de servicio

{
  "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
}

Campaña de donaciones

{
  "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
}

Servicio por suscripción

{
  "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
}
Estos ejemplos usan los parámetros correctos de la API de payment links de Blockradar. El campo metadata debe enviarse como JSON string en form-data, y se admiten cargas de file para contenido adicional.

Pruebas y desarrollo

Entorno sandbox

  • Use redes de testnet para desarrollo
  • Pruebe la entrega y manejo de webhooks
  • Verifique los flujos de pago de extremo a extremo
  • Pruebe casos límite y escenarios de error

Pruebas de webhook

  • Use herramientas como webhook.site para pruebas
  • Verifique la validación de firmas
  • Pruebe los mecanismos de reintento
  • Monitoree las tasas de entrega de webhooks

Plan de Checkout

Blockradar Checkout es una capa de pago programable de stablecoins para aceptar pagos onchain mediante enlaces, códigos QR incrustados y WalletConnect. Los fondos se liquidan directamente en sus wallets no custodiales con soporte integrado para swap, bridge y enrutamiento de tesorería.

Precios

0.75% por transacción

Precios simples y transparentes sin costos de suscripción mensual.

Stablecoins soportadas

  • USDC, USDT, cNGN, IDRX, EUROC y más

Soporte multi-cadena

  • Ethereum, Polygon, Base, Solana, Tron, Celo y más

Gestión de tesorería

  • Swap y Bridge: Convierta y mueva activos entre cadenas
  • Auto-liquidación: Liquide automáticamente en su moneda preferida
  • Circle Gateway: Acceda al protocolo de transferencia cross-chain de Circle
  • Auto-sweeping: Consolide los fondos en su master wallet
Este plan no incluye las funcionalidades de Wallet-as-a-Service (WaaS) ni el aprovisionamiento de wallets dedicadas para sus usuarios finales.

Obtención de transacciones de un enlace de pago

Puede recuperar todas las transacciones asociadas a un enlace de pago específico usando el endpoint de transacciones dedicado. Esto es útil para:
  • Seguimiento de pagos: Monitoree todos los pagos recibidos a través de un enlace específico
  • Conciliación: Empareje pagos con órdenes o facturas
  • Reportes: Genere informes para enlaces de pago específicos

Parámetros de query

ParámetroTipoDescripción
pagenumberNúmero de página para paginación (predeterminado: 1)
limitnumberNúmero de resultados por página (predeterminado: 10)
statusstringFiltrar por estado de transacción (p. ej., SUCCESS, PENDING, FAILED)
typestringFiltrar por tipo de transacción (p. ej., DEPOSIT)
orderstringOrden de clasificación (ASC o DESC)

Ejemplo de respuesta

{
  "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
  }
}

Soporte y recursos

Referencia de la API

Obtener ayuda

Checkout y los enlaces de pago son una manera potente de aceptar pagos en stablecoins con un esfuerzo mínimo de integración. Empiece con casos de uso simples y agregue complejidad gradualmente a medida que se familiarice con el sistema.