Enlaces de Pago - Blockradar

Los enlaces de pago proporcionan una forma sencilla de aceptar pagos con stablecoins sin requerir que los clientes tengan una cuenta de Blockradar o integrar directamente con tu aplicación.

Introducción

Los enlaces de pago son URLs compartibles que permiten a cualquiera enviar pagos con stablecoins a tu billetera. Son perfectos para:

E-commerce: Enviar a clientes para compras de productos
Facturación: Incluir en facturas por servicios prestados
Donaciones: Compartir en redes sociales o sitios web
Pagos de marketplace: Facilitar transacciones entre pares
Facturación de suscripciones: Cobro de pagos recurrentes

Cómo Funcionan los Enlaces de Pago

Creación

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

Comparte la URL generada con tus clientes a través de correo electrónico, mensajería o incrústala en tu sitio web.

Pago

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

Confirmación

Recibes notificaciones webhook y puedes rastrear el estado del pago en tiempo real.

Características de los Enlaces de Pago

Parámetros Personalizables: Establece monto, descripción, límites de pago y metadatos
URLs Compartibles: Genera enlaces de pago únicos para cada transacción
Pre-llenado del Cliente: Pre-completa los detalles del cliente mediante parámetros de consulta URL
Seguimiento en Tiempo Real: Monitorea el estado del pago y recibe notificaciones webhook
Soporte Multi-red: Acepta pagos a través de diferentes redes blockchain
Integración de Auto-barrido: Los fondos se consolidan automáticamente en la billetera principal

Soporte Multi-activo

USDT, USDC, DAI, BUSD a través de múltiples blockchains
Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Tron, Solana, Celo
Conversión y enrutamiento automático para una experiencia de usuario óptima

Configuración Flexible

Montos fijos para productos/servicios específicos
Montos variables para donaciones o pagos personalizados
Límites de pago para garantizar pagos oportunos
Metadatos personalizados para seguimiento y análisis
Notificaciones webhook para actualizaciones en tiempo real

Seguridad y Cumplimiento

Verificación AML en todos los pagos entrantes
Validación de direcciones y verificación
Detección de fraude y prevención
Cumplimiento regulatorio en todas las jurisdicciones

Flujo de Pago

1. Creación del Enlace de Pago

Cuando creas un enlace de pago, Blockradar devuelve una URL de pago única:

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

2. Pre-llenado del Cliente con Parámetros de Consulta

Puedes mejorar la URL de pago con parámetros de consulta para pre-llenar automáticamente los detalles del cliente en la página de pago:

https://pay.blockradar.co/payment-link-10012?name=Cliente&[email protected]&reference=ORDEN123&amount=99.99&redirectUrl=https://tusitio.com/exito-pago

Parámetros de Consulta Opcionales Soportados:

name - Nombre del cliente (aparece en la página de pago)
email - Dirección de correo electrónico del cliente
reference - Referencia personalizada que se incluirá en las respuestas de transacción
amount - Pre-llenar el monto del pago (anula el monto predeterminado del enlace si está configurado)
redirectUrl - URL a la que redirigir después de completar el pago

3. Redirección Post-Pago

Cuando se proporciona un redirectUrl, los clientes serán redirigidos automáticamente a tu URL especificada después de que se complete el procesamiento del pago. La URL de redirección incluirá los siguientes parámetros de consulta: Parámetros de Consulta de Redirección:

status - Estado del pago (success, failed, pending)
tx_reference - ID de referencia de la transacción
reference - Tu referencia personalizada (si se proporcionó)
slug - Identificador del enlace de pago

Ejemplo de URL de Redirección:

https://tusitio.com/exito-pago?status=success&tx_reference=tx_abc123&reference=ORDEN123&slug=payment-link-10012

La redirección solo ocurre después de que se complete el procesamiento del pago. Si no se proporciona redirectUrl, los clientes verán la página de finalización de pago predeterminada.

4. Configuración de Monto

Los enlaces de pago admiten dos modos de monto: Monto Fijo (Preestablecido)

Cuando especificas 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 producto por exactamente $99.99

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 detalles pre-llenados y completan la transacción usando su stablecoin preferida.

5. Respuesta de Transacción

El parámetro reference de la URL se incluirá en la respuesta de transacción y en los payloads de webhook, permitiéndote vincular los pagos de vuelta a tus sistemas internos.

Pruébalo

Experimenta los enlaces de pago de Blockradar de primera mano con nuestra demostración en vivo: 🔗 Enlace de Pago Demo: https://pay.blockradar.co/demo Esta demostración 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 Stablecoin: Múltiples métodos de pago y redes
Actualizaciones en Tiempo Real: Estado de transacción en vivo y confirmaciones

El enlace de pago de demostración es solo para fines de prueba. No se procesarán transacciones reales.

Creación de Enlaces de Pago

Enlace de Pago Básico

Crea un enlace de pago simple para un monto fijo:

{
  "name": "Compra de Producto",
  "description": "Pago por Laptop Pro 2024",
  "amount": "100.00",
  "redirectUrl": "https://tienda.ejemplo.com/gracias",
  "successMessage": "¡Gracias por tu compra!",
  "metadata": "{\"product_id\": \"prod_123\", \"order_id\": \"ord_456\"}"
}

Enlace de Pago de Monto Variable

Permite a los clientes elegir su monto de pago:

{
  "name": "Campaña de Donaciones",
  "description": "Apoya nuestros esfuerzos de ayuda en desastres",
  "redirectUrl": "https://caridad.ejemplo.com/gracias",
  "successMessage": "¡Gracias por tu generosa donación!",
  "metadata": "{\"campaign\": \"disaster_relief_2024\"}"
}

Enlace de Pago con Carga de Archivo

Incluye un archivo (por ejemplo, factura, imagen de producto) con tu enlace de pago usando form-data: Campos de Form Data:

name: Factura de Servicio
description: Servicios de desarrollo web - Enero 2024
amount: 1500.00
redirectUrl: https://empresa.ejemplo.com/exito-pago
successMessage: ¡Pago recibido! Comenzaremos a trabajar en tu proyecto.
metadata: invoice_id: INV-2024-001, service: web_development
file: [cover.png] (carga de archivo)

Al incluir cargas de archivos, usa form-data en lugar de JSON. El archivo se almacenará y estará accesible a través del enlace de pago.

Parámetros del Enlace de Pago

Parámetros Requeridos

Parámetro	Tipo	Descripción
`name`	string (max: 250)	El nombre del enlace de pago

Parámetros Opcionales

Parámetro	Tipo	Descripción
`description`	string (max: 250)	Una descripción del enlace de pago
`slug`	string (max: 250)	Un identificador único (compatible con URL). Debe coincidir con regex: `^[a-zA-Z0-9-]+$`
`amount`	string	El monto para el enlace de pago. Debe ser un número de cadena válido > 0
`redirectUrl`	string (URL)	La URL a la que redirigir al usuario después del pago. Debe incluir http:// o https://
`successMessage`	string (max: 500)	Mensaje que se muestra cuando el pago tiene éxito
`inactiveMessage`	string (max: 500)	Mensaje que se muestra cuando el enlace de pago está inactivo
`metadata`	object (JSON string)	Metadatos personalizados como pares clave-valor (string o número). Debe enviarse como una cadena JSON en form-data
`paymentLimit`	number (min: 1)	Número máximo de pagos permitidos para este enlace
`file`	file	Una carga de archivo opcional (por ejemplo, imagen o documento) adjunta al enlace de pago

Flujo de Pago

Experiencia del Cliente

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
Seleccionar Método de Pago
- Elegir entre stablecoins disponibles
- Seleccionar red blockchain preferida
- Ingresar monto de pago (si es variable)
Completar el Pago
- El cliente confirma los detalles de la transacción
- El pago se procesa en la blockchain
- Confirmación en tiempo real y actualizaciones de estado
Confirmación de Éxito
- Página de confirmación de pago
- Redirección opcional a tu sitio web
- Recibo y detalles de transacción

Experiencia del Comerciante

Notificaciones en Tiempo Real
- Eventos webhook para el estado del pago
- Notificaciones por correo electrónico (si está configurado)
- Actualizaciones del panel de control
Seguimiento de Pagos
- Historial y estado de transacciones
- Análisis y reportes de pagos
- Integración con tus sistemas

Eventos Webhook

Los enlaces de pago activan los siguientes eventos webhook cuando se reciben pagos:

Evento	Descripción
`deposit.success`	El pago fue recibido a través del enlace de pago
`deposit.failed`	El intento de pago falló

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

Campos Clave de Datos del Webhook

El payload del webhook incluye información completa sobre el pago:

Campo	Descripción
`reference`	Referencia personalizada de los parámetros de consulta URL (por ejemplo, ORDER123, ID del cliente)
`paymentLink`	Detalles completos del enlace de pago incluyendo nombre, descripción y metadatos
`asset`	Información del activo (USDC, USDT, etc.) con detalles de la red
`blockchain`	Información de la red (Base, Ethereum, etc.)
`wallet`	Detalles de la billetera principal y configuraciones
`address`	Dirección del cliente que recibió el pago
`amlScreening`	Resultados de la verificación contra el lavado de dinero
`assetSwept`	Estado y detalles del auto-barrido
`metadata`	Datos personalizados del enlace de pago

El campo reference en los payloads de webhook corresponde al parámetro de consulta reference que incluyes en la URL de pago. Esto te permite rastrear los pagos de vuelta a pedidos específicos, clientes o referencias internas en tu sistema.

Mejores Prácticas

Seguridad

Usa HTTPS para compartir todos los enlaces de pago
Monitorea los eventos webhook en busca de actividad sospechosa
Implementa limitación de tasa en tus endpoints de webhook

Experiencia del Usuario

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

Integración

Almacena los IDs de enlaces de pago para seguimiento
Usa metadatos para vincular pagos a tus sistemas
Implementa lógica de reintento de webhook para confiabilidad
Prueba los webhooks en el entorno sandbox primero

Casos de Uso y Ejemplos

Tienda de E-commerce

{
  "name": "Laptop Pro 2024",
  "description": "Laptop de alto rendimiento con las últimas especificaciones",
  "amount": "299.99",
  "redirectUrl": "https://tienda.ejemplo.com/gracias",
  "successMessage": "¡Gracias por tu compra! Tu pedido ha sido confirmado.",
  "metadata": "{\"product_id\": \"laptop_pro_2024\", \"category\": \"electronics\", \"customer_email\": \"[email protected]\"}",
  "paymentLimit": 1
}

Factura de Servicio

{
  "name": "Servicios de Desarrollo Web",
  "description": "Servicios profesionales de desarrollo web - Enero 2024",
  "amount": "1500.00",
  "redirectUrl": "https://empresa.ejemplo.com/exito-pago",
  "successMessage": "¡Pago recibido! Comenzaremos a trabajar en tu proyecto inmediatamente.",
  "metadata": "{\"invoice_id\": \"INV-2024-001\", \"service\": \"web_development\", \"client_id\": \"client_789\"}",
  "paymentLimit": 1
}

Campaña de Donaciones

{
  "name": "Ayuda en Desastres 2024",
  "description": "Apoya nuestros esfuerzos de ayuda en desastres en regiones afectadas",
  "amount": "10.00",
  "redirectUrl": "https://caridad.ejemplo.com/gracias",
  "successMessage": "¡Gracias por tu generosa donación! Cada contribución hace la diferencia.",
  "metadata": "{\"campaign\": \"disaster_relief_2024\", \"organization\": \"charity_foundation\", \"tax_deductible\": true}",
  "paymentLimit": 1000
}

Servicio de Suscripción

{
  "name": "Plan Premium Mensual",
  "description": "Suscripción mensual a nuestro servicio premium",
  "amount": "29.99",
  "redirectUrl": "https://servicio.ejemplo.com/bienvenida",
  "successMessage": "¡Bienvenido a Premium! Tu suscripción ahora está activa.",
  "metadata": "{\"plan\": \"premium_monthly\", \"billing_cycle\": \"monthly\", \"features\": \"unlimited_access\"}",
  "paymentLimit": 100
}

Estos ejemplos usan los parámetros correctos de la API de enlaces de pago de Blockradar. El campo metadata debe enviarse como una cadena JSON en form-data, y las cargas de file son compatibles para contenido adicional.

Pruebas y Desarrollo

Entorno Sandbox

Usa redes testnet para desarrollo
Prueba la entrega y manejo de webhooks
Verifica los flujos de pago de extremo a extremo
Prueba casos extremos y escenarios de error

Prueba de Webhooks

Usa herramientas como webhook.site para pruebas
Verifica la validación de firma
Prueba mecanismos de reintento
Monitorea las tasas de entrega de webhooks

Soporte y Recursos

Referencia de API

Obtener Ayuda

Email: [email protected]
Referencia de API: Enlaces de Pago

Los enlaces de pago son una forma poderosa de aceptar pagos con stablecoins con un esfuerzo de integración mínimo. Comienza con casos de uso simples y gradualmente añade complejidad a medida que te familiarices más con el sistema.

Comenzar

Esenciales

​Introducción

​Cómo Funcionan los Enlaces de Pago

Creación

Compartir

Pago

Confirmación

​Características de los Enlaces de Pago

​Soporte Multi-activo

​Configuración Flexible

​Seguridad y Cumplimiento

​Flujo de Pago

​1. Creación del Enlace de Pago

​2. Pre-llenado del Cliente con Parámetros de Consulta

​3. Redirección Post-Pago

​4. Configuración de Monto

​4. Procesamiento del Pago

​5. Respuesta de Transacción

​Pruébalo

​Creación de Enlaces de Pago

​Enlace de Pago Básico

​Enlace de Pago de Monto Variable

​Enlace de Pago con Carga de Archivo

​Parámetros del Enlace de Pago

​Parámetros Requeridos

​Parámetros Opcionales

​Flujo de Pago

​Experiencia del Cliente

​Experiencia del Comerciante

​Eventos Webhook

​Ejemplo de Payload de Webhook

​Campos Clave de Datos del Webhook

​Mejores Prácticas

​Seguridad

​Experiencia del Usuario

​Integración

​Casos de Uso y Ejemplos

​Tienda de E-commerce

​Factura de Servicio

​Campaña de Donaciones

​Servicio de Suscripción

​Pruebas y Desarrollo

​Entorno Sandbox

​Prueba de Webhooks

​Soporte y Recursos

​Referencia de API

​Obtener Ayuda

Introducción

Cómo Funcionan los Enlaces de Pago

Características de los Enlaces de Pago

Soporte Multi-activo

Configuración Flexible

Seguridad y Cumplimiento

Flujo de Pago

1. Creación del Enlace de Pago

2. Pre-llenado del Cliente con Parámetros de Consulta

3. Redirección Post-Pago

4. Configuración de Monto

4. Procesamiento del Pago

5. Respuesta de Transacción

Pruébalo

Creación de Enlaces de Pago

Enlace de Pago Básico

Enlace de Pago de Monto Variable

Enlace de Pago con Carga de Archivo

Parámetros del Enlace de Pago

Parámetros Requeridos

Parámetros Opcionales

Flujo de Pago

Experiencia del Cliente

Experiencia del Comerciante

Eventos Webhook

Ejemplo de Payload de Webhook

Campos Clave de Datos del Webhook

Mejores Prácticas

Seguridad

Experiencia del Usuario

Integración

Casos de Uso y Ejemplos

Tienda de E-commerce

Factura de Servicio

Campaña de Donaciones

Servicio de Suscripción

Pruebas y Desarrollo

Entorno Sandbox

Prueba de Webhooks

Soporte y Recursos

Referencia de API

Obtener Ayuda