Documentación

blockwallets te permite aceptar USDT y USDC, además de BTC, LTC y monedas nativas (acreditadas en dólares estadounidenses a una tasa bloqueada). Todas las integraciones de abajo crean el mismo tipo de factura en la misma página de pago alojada, con las mismas confirmaciones, comisiones y saldo; solo cambia cómo se comunica tu sistema con nosotros. Elige la que mejor te encaje y sigue su página.

Elige una integración

Agrupadas según tu punto de partida. Cada tarjeta abre la guía completa.

Sin código

Cobra desde el panel del comercio; no hay nada que instalar.

Nueva integración por API

Vas a escribir la integración desde cero.

Migrar desde otra pasarela

Conserva tu código: APIs compatibles, así que solo cambias la URL base y las claves.

Que lo integre una IA

Para quien no programa pero usa una herramienta de programación con IA.

Herramientas

Ayuda para depurar que se ejecuta en tu navegador.

¿Compatible con Cryptomus o nativa?

Ambas crean las mismas facturas en la misma página de pago, con las mismas comisiones y el mismo saldo. La diferencia está en el estilo de las peticiones, el formato del webhook y cómo obtienes las credenciales.

¿Empiezas de cero? Usa la API REST nativa: importes en centavos, ref idempotente, firmas de webhook con marca de tiempo y claves que generas tú mismo en el panel. ¿Ya usas Cryptomus o quieres usar un SDK o plugin de Cryptomus existente? Usa la API compatible con Cryptomus.

Inicio rápido

De cero a un pago de prueba en cinco pasos (API compatible con Cryptomus; las demás APIs siguen los mismos pasos con sus propias credenciales).

1. Solicita acceso en la página de inicio. Cuando te aprueben, entra en el panel del comercio.
2. Abre “Desarrolladores › Integración y claves” en el panel, genera un merchant y una API key en la columna Test y añade los dominios de tu sitio web.
3. Tu servidor crea una factura con POST /v1/payment y redirige al cliente a result.url.
4. Págala con “Simular pago” en la página de pago y comprueba que tu manejador de webhooks verifica sign y acredita según payment_amount_usd.
5. Cambia a las credenciales de la columna Live y paga una vez un importe real pequeño (“Probar un pago” en la página de inicio del panel).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

El código en Node.js, PHP y Python para cada paso está en la documentación de la API compatible con Cryptomus; si prefieres que lo haga una IA, empieza por el generador de prompts.

Enlaces de pago (sin código)

Panel del comercio → “Cobros › Enlaces de pago” → escribe una descripción y un importe (fija una red o deja que el cliente elija) → crear. Cada enlace tiene una URL y un código QR.

• Cada vez que alguien abre el enlace se crea una factura nueva, así que un mismo enlace se puede reutilizar (p. ej. “Membresía $99”).
• Cada pago aparece en “Cobros › Transacciones”; retíralo a tu billetera desde “Fondos › Saldo y retiros”.
• Si has creado credenciales y una URL de webhook en “Desarrolladores › Integración y claves”, los pagos hechos con enlaces también se notifican, en el formato de webhook compatible con Cryptomus.
• Para dejar de aceptar pagos, pulsa “Desactivar” y el enlace deja de funcionar de inmediato.

TPV para tiendas

Para mostradores y puestos: panel del comercio → “Cobros › TPV” → abre un terminal y obtén un enlace de TPV. El personal lo abre en un móvil o tableta, escribe un importe y aparece un código QR de pago; cuando el cliente paga, la pantalla muestra “Paid”.

• Una factura de TPV es válida durante 30 minutos. Los pagos van a tu saldo y aparecen en “Cobros › Transacciones”, y se te notifica en tu URL de webhook igual que con los enlaces de pago.
• Un enlace de TPV solo puede cobrar: no ve tu saldo, retiros, otros pedidos, ajustes ni credenciales.
• ¿Perdiste un dispositivo o se fue un empleado? Revoca ese terminal en el panel y su enlace deja de funcionar al instante.

Botón para tu web

Panel del comercio → “Cobros › Enlaces de pago” → “Botón para tu web”: elige el texto, el color, el tamaño y la forma y copia el fragmento. Al hacer clic en el botón se abre la página de pago de ese enlace de pago.

• HTML sencillo: un enlace con estilo y sin script, así que funciona donde puedas pegar HTML (creadores de sitios, foros, firmas de correo).
• Con el script: añade data-blockwallets y una etiqueta /embed.js; en escritorio la página de pago se abre en una ventana pequeña centrada, en móviles se abre de la forma normal.
• El script no envía peticiones, no crea cookies ni añade ningún iframe. Si la página lo bloquea, el botón sigue siendo un enlace normal que funciona.

En los fragmentos de abajo, sustituye /l/pl_… por la dirección de tu propio enlace de pago.

HTML sencillo

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + script

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>