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.
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:Clave API
Obtenga su clave API desde el Dashboard de Blockradar. Vaya a Developers para generar una.
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.
Plan de Checkout activo
Asegúrese de que la función Checkout esté habilitada en su cuenta. Contacte a [email protected] si necesita activarla.
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: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:name- Nombre del cliente (aparece en la página de pago)email- Correo electrónico del clientereference- Referencia personalizada que se incluirá en las respuestas de transacciónamount- 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 unredirectUrl, 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ónreference- Su referencia personalizada (si se proporcionó)slug- Identificador del enlace de pago
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
amountdurante 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
- 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ámetroreference 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:Enlace de pago con monto variable
Permita que los clientes elijan el monto de su pago: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 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] (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ámetro | Tipo | Descripción |
|---|---|---|
name | string (máx: 250) | El nombre del enlace de pago |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
description | string (máx: 250) | Una descripción del enlace de pago |
slug | string (máx: 250) | Un identificador único (apto para URL). Debe coincidir con la regex: ^[a-zA-Z0-9-]+$ |
amount | string | El monto del enlace de pago. Debe ser un número en string 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 (máx: 500) | Mensaje mostrado cuando el pago se realiza con éxito |
inactiveMessage | string (máx: 500) | Mensaje mostrado cuando el enlace de pago está inactivo |
metadata | object (JSON string) | Metadata personalizada como pares clave-valor (string o número). Debe enviarse como JSON string en form-data |
paymentLimit | number (mín: 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 el método de pago
- Elegir entre las stablecoins disponibles
- Seleccionar la red blockchain preferida
- Ingresar el monto del 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 y actualizaciones de estado en tiempo real
-
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
-
Notificaciones en tiempo real
- Eventos de webhook para el estado del pago
- Notificaciones por correo electrónico (si está configurado)
- Actualizaciones del dashboard
-
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
Eventos de webhook
Los enlaces de pago activan los siguientes eventos de webhook cuando se reciben pagos:| Evento | Descripción |
|---|---|
deposit.success | Se recibió un pago a través del enlace de pago |
deposit.failed | El intento de pago falló |
Ejemplo de carga útil de webhook
Campos clave de los datos de webhook
La carga útil del webhook incluye información completa sobre el pago:| Campo | Descripción |
|---|---|
reference | Referencia personalizada de los parámetros de query de la URL (p. ej., ORDER123, ID de cliente) |
paymentLink | Detalles completos del enlace de pago, incluidos nombre, descripción y metadata |
asset | Información del activo (USDC, USDT, etc.) con detalles de la red |
blockchain | Información de la red (Base, Ethereum, etc.) |
wallet | Detalles y configuraciones de la master wallet |
address | Dirección del cliente que recibió el pago |
amlScreening | Resultados del screening contra lavado de dinero |
assetSwept | Estado y detalles del auto-sweep |
metadata | Datos 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
Factura de servicio
Campaña de donaciones
Servicio por suscripción
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ámetro | Tipo | Descripción |
|---|---|---|
page | number | Número de página para paginación (predeterminado: 1) |
limit | number | Número de resultados por página (predeterminado: 10) |
status | string | Filtrar por estado de transacción (p. ej., SUCCESS, PENDING, FAILED) |
type | string | Filtrar por tipo de transacción (p. ej., DEPOSIT) |
order | string | Orden de clasificación (ASC o DESC) |
Ejemplo de respuesta
Soporte y recursos
Referencia de la API
- Crear enlace de pago
- Obtener todos los enlaces de pago
- Obtener enlace de pago
- Actualizar enlace de pago
- Obtener transacciones del enlace de pago
Obtener ayuda
- Correo electrónico: [email protected]
- Referencia de la API: Checkout
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.

