Pagos cripto para Blesta
Acepta cripto en las facturas de Blesta. SnapEX Pay es una pasarela non-merchant: el cliente elige SnapEX Pay (Crypto), paga en la página de SnapEX Pay en USDT en TRON, Ethereum, BSC y otras redes, o en otras monedas convertidas a USDT, y el pago se registra en Blesta y se aplica a las facturas automáticamente.
Gratis. Versión 1.0.0.
Qué hace
- Sin billeteras ni nodos que mantener: los fondos llegan a tu saldo de comercio en SnapEX Pay.
- El pago se registra con el webhook firmado o en cuanto el cliente vuelve a la página de "pago recibido", lo que ocurra primero. En ambos casos la factura se vuelve a leer primero desde la API de SnapEX Pay: el cuerpo del webhook por sí solo nunca marca nada como pagado, y un pago nunca se registra dos veces.
- Cualquier moneda de factura: los importes que no están en USD se convierten a USD con los tipos de cambio que Blesta ya guarda, y la transacción se registra en la moneda de la factura.
- Los pagos parciales nunca se aplican automáticamente: quedan como una transacción pendiente para que la revises.
- Modo de prueba: las facturas de prueba se confirman solas sin dinero real; mientras está activo, solo el personal que inicia sesión como cliente ve el botón, y a los demás clientes se les pide elegir otro método de pago.
Instalación
- Sube el contenido del archivo a la carpeta raíz de Blesta respetando la ruta
components/gateways/nonmerchant/snapex_pay/. - En el panel de administración de Blesta abre Settings → Payment Gateways → Available, busca SnapEX Pay (Crypto) y pulsa Install. La instalación crea una tabla,
snapex_pay_invoices. - En el panel del comercio de SnapEX Pay crea una clave API con los permisos
invoices.readeinvoices.writey pégala en API key. - Webhook (obligatorio): en el panel añade un webhook con la URL
https://<your Blesta>/callback/gw/<company id>/snapex_pay/(la dirección exacta aparece en los ajustes de la pasarela) y pega el secretowhsec_…en Webhook secret. Blesta no tiene cron para las pasarelas, así que el webhook es la vía por la que llegan los pagos cuando el cliente no vuelve al sitio. - Si tus facturas no están en USD, añade USD en Settings → Company → Currencies con un tipo de cambio (o deja que Blesta actualice los tipos automáticamente). Marca las monedas para las que se debe ofrecer la pasarela.
- Activa Test mode, entra en el área de cliente como un cliente desde el panel de administración, paga una factura en la página de SnapEX Pay con un método de prueba y comprueba que la factura queda pagada. Después desactiva el modo de prueba.
Ajustes
| API key | Del panel de SnapEX Pay. Se guarda cifrada. |
|---|---|
| Webhook secret | whsec_… de los ajustes de webhook del panel. Obligatorio. Se guarda cifrado. |
| Network fee paid by | Merchant: el cliente paga exactamente el importe de la factura. Client: la comisión se suma encima. |
| Payment window, minutes | Cuánto tiempo es válida la página de pago (1–1440, por defecto 60). Si se vuelve a pagar más tarde, se abre una nueva. |
| Test mode | Facturas de prueba; mientras está activo, solo el personal ve el botón. Los pagos de prueba se ignoran una vez desactivado el modo de prueba. |
| Partner ID | Opcional: el Partner ID del integrador que configuró el módulo (programa de referidos de SnapEX Pay). Déjalo vacío si lo instalas tú mismo. |
| API URL | Déjalo como está. |
Preguntas
¿Por qué el webhook es obligatorio?
Blesta no tiene cron para las pasarelas. Si el cliente paga y no vuelve al sitio, el webhook firmado es la vía por la que el pago llega a Blesta. Si el cliente vuelve, el pago se registra al momento y nunca se registra dos veces.
Mis facturas no están en USD. ¿Funcionará?
Sí. Añade USD en Settings → Company → Currencies con un tipo de cambio. Los importes se convierten con los tipos de Blesta, y la transacción se registra en la moneda de la factura.
¿Qué aparece en Blesta cuando se paga una factura?
Una transacción aprobada en la moneda de la factura, aplicada a las facturas pagadas. El ID de la transacción es el ID de la factura de SnapEX Pay (inv_…), y el cliente recibe el correo habitual de Blesta de pago recibido.
¿Y si el cliente envía menos del importe de la factura?
Si el cliente no completa el pago a tiempo, se registra una transacción pendiente con el importe recibido en su mensaje, sin aplicarla. Revísala en las transacciones del cliente.
¿Y si la página de pago caduca sin pago?
No se registra nada. Si el dinero llega después de cerrarse la factura, el log de la pasarela recibe una entrada; el dinero está en tu saldo de SnapEX Pay.
¿Dónde veo lo que hizo el módulo?
En Blesta, Tools → Logs → Gateway.
Otras integraciones
¿Listo para aceptar cripto?
Crea una cuenta de comercio, obtén una clave API y conecta el módulo. 1% por pago, sin cuota mensual.