Conectores

Cobra con tarjeta en tu tienda, con los campos dentro de tu propio checkout o mandando al cliente al checkout de ROKI. Checkout clasico y por bloques, reembolsos desde el panel, y conciliacion automatica si se pierde un webhook.

Dos formas de cobrar, se elige en los ajustes

Necesitas: WordPress 6.2 o superior, WooCommerce 8.0 o superior, PHP 8.0 o superior

Como se instala

1. Descarga el archivo ZIP.
2. En tu WordPress, entra a Plugins → Anadir nuevo → Subir plugin, elegi el ZIP y activalo.
3. Anda a WooCommerce → Ajustes → Pagos → ROKI Connect.
4. Pega tu llave secreta. Empieza con sk_test_ para probar y con sk_live_ para cobrar de verdad; la encontras en la pestana Integracion API del portal.
5. Aca elegis el modo. En el desplegable Como cobra hay dos opciones, que son los dos modos comparados arriba:
   • "Checkout de ROKI (el cliente sale de tu tienda)" es el modo 1, y viene puesto por defecto.
   • "Campos de tarjeta en tu tienda" es el modo 2: el cliente paga sin irse.
6. Si elegiste el modo 2, pega tambien la llave publicable (pk_test_ o pk_live_), de la misma pestana del portal, y asegurate de que tu tienda sea HTTPS. Sin esas dos cosas el plugin vuelve solo al checkout de ROKI, y el diagnostico te dice por que.
7. Copia la URL del webhook que te muestra esa misma pantalla, registrala en el portal en la pestana Webhooks, y pega aca el secreto de firma que te devuelva.
8. Aprieta Ejecutar diagnostico. Si los cinco puntos salen en verde, ya podes cobrar.

Que hace por vos

Los campos en tu tienda	El cliente no se va: ROKI dibuja los campos de tarjeta dentro de tu checkout, en un iframe seguro, y el numero nunca pasa por tu servidor. Se elige en los ajustes; el checkout alojado queda como respaldo.
Checkout por bloques	Los dos modos andan en el checkout nuevo de WooCommerce, no solo en el clasico.
Reembolsos y anulaciones	Desde la orden en WooCommerce. Si la transaccion todavia se puede anular lo hace asi, que no le aparece al cliente en su estado de cuenta; si no, la reembolsa.
Si se pierde un webhook	Cada cinco minutos revisa las ordenes pendientes y les pregunta a ROKI. Un cliente que pago no queda con la orden colgada.
Comision al cliente	Un interruptor. Si lo activas, ROKI recalcula el total para que a vos te quede el monto de la orden.
Actualizaciones	El aviso te llega al panel de WordPress como el de cualquier otro plugin.

Aca no se descarga nada: el puente corre en los servidores de ROKI y tu tienda solo se conecta. Shopify no deja cobrar con tarjeta dentro de su checkout sin pasar por su programa cerrado de pagos, asi que el puente usa lo que si permite cualquier tienda: el pedido queda pendiente, el cliente recibe su enlace de pago, y al pagar el pedido se marca pagado solo.

Enlace de pago, no HPP ni SPI. Shopify no permite campos de tarjeta de terceros en su checkout salvo por su programa de pagos, que es cerrado y por aprobacion. Tampoco deja redirigir desde el checkout. Lo unico permitido es lo que hace el puente: el pedido queda pendiente y el cliente recibe su enlace de pago.

Dos apps distintas de ROKI para Shopify

El puente esta probado de punta a punta, con entregas de Shopify y pagos reales de sandbox. Se activa por tienda: escribile a ROKI para registrar la tuya, y hace un pedido de prueba con una llave sk_test_ antes de abrirlo a tus clientes.

Necesitas: Cualquier plan de Shopify. No hace falta ser partner ni instalar nada: la tienda crea una app propia y un metodo de pago manual desde su propio panel.

Como se instala

1. En tu Shopify, anda a Configuracion → Pagos → Metodos de pago manuales y crea uno llamado Tarjeta de credito o debito (ROKI).
2. Habilita las apps propias en Configuracion → Aplicaciones y canales de venta → Desarrollar aplicaciones, crea una con permisos read_orders y write_orders, e instalala. Copia el token de acceso.
3. Escribile a ROKI con el dominio de tu tienda. ROKI te da de alta y te devuelve tus dos direcciones del puente: https://connect.roki.la/shopify/pedido/<tu-tienda> para Shopify y https://connect.roki.la/shopify/roki/<tu-tienda> para el portal de ROKI.
4. En Configuracion → Notificaciones → Webhooks crea uno del evento Creacion de pedidos con tu direccion de pedido como URL, y compartile a ROKI por canal seguro el secreto de firma que muestra esa pantalla junto con el token del paso 2.
5. En el portal de ROKI registra tu direccion de roki como webhook. Con eso el alta queda completa y todo corre solo: pedido pendiente → enlace por correo → pagado.

Que hace por vos

Como se siente para el cliente	Hace su pedido, le llega el enlace por correo, paga en el checkout de ROKI y vuelve a la pagina de estado de su pedido en Shopify.
Si se pierde un webhook	El puente revisa cada cinco minutos los pagos pendientes y le pregunta a ROKI, igual que el plugin de WooCommerce.
Pedidos duplicados	La llave de idempotencia sale del contenido del pedido: un webhook reenviado devuelve el mismo pago en vez de crear otro.
Lo que no hace	No cobra dentro del checkout de Shopify. Eso exige su programa de pagos, que es cerrado y por aprobacion; el pago aca es el paso siguiente al pedido.

Recibi donaciones con tarjeta en tus formularios de GiveWP. Para iglesias, ONGs, colectas y colegios que piden aportes: lo que hoy se cobra por transferencia y captura de pantalla.

Checkout de ROKI (HPP). El donante sale a la pagina de ROKI, paga y vuelve. Los campos dentro del formulario estan planificados.

Corrido contra un GiveWP 4 real: la pasarela aparece en los formularios nuevos y en los viejos, la donacion se crea, el cobro se hace contra el sandbox y el aviso firmado la marca completa. Como con cualquier medio de pago, probalo primero en una copia de tu sitio y hace una donacion con una llave sk_test_ antes de recibir plata de verdad.

Necesitas: WordPress 6.2 o superior, GiveWP 3.0 o superior, PHP 7.4 o superior.

Como se instala

1. Descarga el ZIP e instalalo desde Plugins → Anadir nuevo → Subir plugin.
2. Anda a Donaciones → Ajustes → Pasarelas de pago y abri la seccion ROKI Connect.
3. Pega tu llave secreta en Llave secreta de sandbox para probar, o en la de produccion para cobrar de verdad.
4. Copia la URL del webhook que muestra esa pantalla, registrala en el portal de ROKI y pega aca el Secreto de firma del webhook.
5. En Donaciones → Ajustes → General pone la moneda en Lempira hondureno. ROKI cobra en lempiras: con otra moneda el plugin se detiene antes de cobrar en vez de cobrar un monto equivocado.
6. Activa ROKI Connect en el formulario y hace una donacion de prueba con una llave de sandbox.

Que hace por vos

Formularios nuevos y viejos	Funciona igual en el constructor visual de GiveWP y en los formularios de la generacion anterior, que es lo que muchas organizaciones ya tienen armado.
Reembolsos desde el panel	Se intenta anular primero, que no le aparece al donante en su estado de cuenta; si ya liquido, se reembolsa.
De quien es cada aviso	Cada donacion lleva su propia clave. Un pago hecho en otro sitio con la misma cuenta de ROKI no puede completar una donacion de este.
Lo que no hace	No marca una donacion como recibida porque el donante haya vuelto del checkout. Volver significa que el navegador volvio, no que el dinero se movio.

Modulo de pago del mismo tipo que el de WooCommerce: el cliente paga en el checkout de ROKI y el pedido se confirma cuando el pago esta verificado.

Checkout de ROKI (HPP). Los campos dentro de la tienda estan planificados aca tambien.

Instalado y verificado en una tienda PrestaShop 8 real: el modulo queda activo con sus ganchos, crea su propio estado de pedido y aparece como "Pagar con ROKI Connect" en el paso de pago del checkout. Como con cualquier medio de pago, probalo primero en una copia y hace un pedido con una llave sk_test_ antes de pasar a produccion.

Necesitas: PrestaShop 8.0 o superior, PHP 8.1 o superior, con cURL y OpenSSL.

Como se instala

1. Descarga el ZIP.
2. En tu PrestaShop, entra a Modulos → Gestor de modulos → Subir un modulo y elegi el archivo.
3. Abri la configuracion del modulo y pega tu llave secreta: sk_test_ para probar, sk_live_ para cobrar.
4. Copia la URL del webhook que muestra esa pantalla, registrala en el portal de ROKI y pega el secreto de firma.
5. Habilita ROKI Connect en Pagos → Preferencias para las monedas y paises que corresponda.
6. Hace un pedido de prueba con una llave de sandbox antes de pasar a produccion.

Que hace por vos

Estado propio del pedido	Crea "Pendiente de pago (ROKI Connect)" en vez de usar los nativos: marcar como pagado sin confirmacion, o como error mientras el cliente todavia esta pagando, son los dos errores clasicos.
Reembolsos y anulaciones	Desde la ficha del pedido en el panel.
Si se pierde un webhook	Una tarea programada revisa los pedidos pendientes y le pregunta a ROKI.

Metodo de pago para Magento 2, construido sobre su arquitectura de comandos de pasarela, que es la recomendada desde la 2.3.

Checkout de ROKI (HPP). Los campos dentro de la tienda estan planificados para Magento.

Instalado y verificado dentro de un Magento 2.4.7-p3 de verdad: setup:di:compile resuelve cada dependencia del modulo, Magento reconoce el metodo de pago entre los suyos, y arma las nueve clases que mueven dinero. Sigue en Beta porque falta lo unico que aca llamamos probado: un cobro completo por el checkout de una tienda. Instalalo primero en una copia y hace un pedido con una llave sk_test_ antes de pasar a produccion.

Necesitas: Magento 2.4 o superior, PHP 8.1 o superior, con acceso por linea de comandos al servidor.

Como se instala

1. Descarga el ZIP y descomprimilo en app/code/, de modo que quede app/code/Roki/Connect.
2. Desde la linea de comandos: bin/magento module:enable Roki_Connect
3. Despues: bin/magento setup:upgrade y bin/magento cache:flush
4. En el panel, anda a Tiendas → Configuracion → Ventas → Metodos de pago y abri la seccion ROKI Connect. Si tenes el panel en ingles, ese camino es Stores → Configuration → Sales → Payment Methods: esos menus los traduce Magento, pero los campos del modulo estan siempre en espanol.
5. Pega tu llave secreta en Llave secreta. El prefijo decide el entorno: sk_test_ prueba y sk_live_ cobra de verdad.
6. Registra la URL del webhook en el portal de ROKI. La pantalla te la muestra como https://SU-DOMINIO/rokiconnect/webhook/index: cambia SU-DOMINIO por el tuyo. El secreto de firma que te devuelva el portal va en Secreto del webhook.
7. Pone Habilitado en Si y hace un pedido de prueba con una llave de sandbox.

Que hace por vos

Arquitectura	Usa comandos de pasarela y manejadores de valor, no el AbstractMethod obsoleto.
La factura	Se genera cuando el pago se confirma, no cuando el cliente vuelve del checkout.
Webhook sin CSRF	El controlador implementa la interfaz que Magento exige para aceptar una llamada de servidor a servidor.

Codigo que pegas en tu sitio de Wix para cobrar montos que dependen de lo que el visitante elige. No es un plugin: Wix no deja publicar una pasarela sin su aprobacion.

Checkout de ROKI (HPP). Los campos de tarjeta dentro de una pagina de Wix necesitarian un servidor propio del comercio, que es justo lo que Wix no da.

Es codigo que se pega a mano en tu sitio, no un plugin que se instala. Proba el flujo completo con una llave sk_test_ y un monto chico, y confirma que el webhook te llega, antes de cobrarle a nadie.

Necesitas: Un sitio de Wix con plan Premium, que es lo que habilita Velo. En un sitio gratuito no hay backend, y sin backend el monto se calcularia en el navegador.

Como se instala

1. Si lo que vendes tiene precio fijo, no necesitas esto: usa el boton de pago y listo.
2. Si el monto depende de lo que el visitante elige, anda a la receta de Wix: son tres bloques de codigo y siete pasos.

Que hace por vos

Por que no hay ZIP	Publicar una pasarela en Wix exige aprobacion comercial de Wix y un permiso que habilitan a mano. Es la misma puerta cerrada que Shopify.
Que si podes hacer	Velo te deja poner codigo propio en cualquier sitio de Wix con plan Premium. Con eso cobras hoy, sitio por sitio.
El monto se calcula en el servidor	El backend de Velo (<code>.jsw</code>) corre del lado de Wix. El navegador manda que eligio el visitante, nunca cuanto cuesta.
Si Wix abre su API	Publicamos el conector de verdad, con instalacion de un click. La receta seguira funcionando igual.

Un fragmento que pegas en tu pagina - hecha con Wix, Squarespace, Webflow o a mano - y ya cobras con tarjeta. Es el camino mas corto si tu sitio no es una tienda.

Checkout de ROKI (HPP). Los campos en la propia pagina necesitan que alguien programe del lado del sitio; el boton existe justamente para los sitios donde eso no pasa.

Necesitas: Una pagina donde puedas pegar HTML. Nada mas: no hace falta servidor, ni base de datos, ni una plataforma en particular.

Como se instala

1. En el portal de ROKI crea un pago con el monto que vas a cobrar, marcado como enlace reutilizable.
2. Copia el enlace que te da, el que empieza con https://aura.roki.systems/pay/.
3. Anda a la pagina del boton, pegalo y elegi como queres que se vea.
4. Copia el fragmento y pegalo en tu pagina, en un bloque de HTML o de codigo incrustado.

Que hace por vos

Un boton, un monto	El monto queda fijo en el enlace. Si vendes cosas de precios distintos, es un enlace y un boton por cada una.
Sin servidor	Tu pagina puede ser completamente estatica. El cobro ocurre del lado de ROKI.
Como sabes que te pagaron	Te llega al portal como cualquier otro cobro. Si tu sitio tiene servidor, registra un webhook y te enteras solo.
Donde funciona	En cualquier lado que acepte pegar HTML: Wix, Squarespace, Webflow, Blogger, una landing hecha a mano, o un correo con el enlace pelado.

Cobra desde el portal del cliente y desde la tienda de Odoo, con el pago registrado contra la factura. Un modulo por version.

Checkout de ROKI (HPP). Odoo permitiria dibujar los campos dentro de su propia pagina, pero son cuatro modulos con dos marcos de pago distintos, y en un cobro contra factura el cliente ya decidio comprar: la redireccion no le cuesta la venta como en una tienda al publico.

Los cinco modulos se instalaron y verificaron en instancias reales de Odoo: el modulo queda instalado, el proveedor de pago creado y su tarea de conciliacion activa. En Odoo 19 ademas se creo un cobro de verdad contra el sandbox desde adentro de Odoo. Como con cualquier medio de pago, instalalo primero en una base de prueba y hace un cobro con una llave sk_test_ antes de pasar a produccion.

Necesitas: Odoo 15, 16, 17, 18 o 19, con acceso al directorio de addons. En Odoo Online no se pueden instalar modulos propios.

Como se instala

1. Descarga el ZIP de tu version de Odoo. No son intercambiables.
2. Descomprimilo dentro de tu directorio de addons, junto a los demas modulos.
3. Reinicia Odoo y actualiza la lista de aplicaciones: Aplicaciones → Actualizar lista de aplicaciones.
4. Busca ROKI Connect e instalalo.
5. Anda a Contabilidad → Configuracion → Proveedores de pago (en Odoo 15, Adquirentes de pago), abri ROKI Connect y pega tu llave secreta.
6. Copia la URL del webhook que muestra esa pantalla, registrala en el portal de ROKI y pega aca el secreto de firma.
7. Pasa el proveedor a Habilitado y hace un cobro de prueba con una llave sk_test_.

Que hace por vos

Un modulo por version	Odoo cambio el modelo de proveedores entre versiones mayores. Instalar el de otra version no falla al copiar: falla al instalar.
Registro del cobro	El pago queda asentado contra la factura del cliente, no como un movimiento suelto.
Si se pierde un webhook	Una tarea programada revisa las transacciones pendientes y les pregunta a ROKI.
Odoo Online	No admite modulos instalados a mano. Para esas cuentas hace falta publicar en su tienda, o integrar por fuera con la API de Odoo.

Cobra con tarjeta las facturas de WHMCS, el sistema que usan las empresas de hosting y los proveedores de internet. Son dos archivos que se copian sobre tu instalacion.

Checkout de ROKI (HPP). El cliente sale a pagar y vuelve. Los campos dentro de WHMCS obligarian a que el numero de tarjeta pase por tu servidor, con todo lo que eso trae encima.

No cobra renovaciones automaticas: cada factura se paga entrando al enlace. Para cobrar sin el cliente presente hay que guardar su tarjeta, y ese modulo se habilita por comercio en ROKI. Si tu cuenta ya lo tiene, escribinos - esa version es un modulo aparte.

Necesitas: WHMCS 8.0 o superior autoalojado, PHP 7.4 o superior con cURL, y acceso por FTP o SSH. En WHMCS Cloud no se pueden subir modulos propios.

Como se instala

1. Descarga el ZIP y descomprimilo.
2. Copia las carpetas modules/gateways/ sobre tu instalacion de WHMCS, por FTP o SSH. No pisan nada de lo que ya tenes.
3. En el panel, anda a Configuracion → Aplicaciones y servicios → Pasarelas de pago, pestana Ver todas las pasarelas, y activa ROKI Connect.
4. Pega tu llave secreta: sk_test_ para probar, sk_live_ para cobrar.
5. Copia la URL del webhook que muestra esa pantalla, registrala en el portal de ROKI y pega aca el secreto de firma.
6. Hace una factura de prueba con una llave de sandbox antes de dejarlo para tus clientes.

Que hace por vos

Quien decide que se pago	La factura se marca pagada con el webhook firmado, no cuando el navegador vuelve. Volver significa que el navegador volvio, no que el dinero se movio.
Reembolsos desde el panel	Se intenta anular primero, que no le aparece al cliente en su estado de cuenta; si ya no se puede, se reembolsa.
El monto que se acredita	Es el de la factura de WHMCS, nunca el que venga en el webhook. Asi, un cuerpo manipulado no puede acreditar de mas.
Comision al cliente	Opcional. ROKI recalcula el total para que a vos te quede el monto de la factura.

Cobra con tarjeta los formularios de tu sitio en WordPress: inscripciones, donaciones, matriculas, reservas. Para el sitio que no es una tienda pero igual necesita cobrar.

Checkout de ROKI (HPP). Los campos de tarjeta dentro del formulario harian pasar el numero por el servidor del sitio, con las obligaciones de PCI que eso trae encima. Gravity Forms lo permite; este conector a proposito no lo usa.

Version Beta. Instalala primero en una copia de prueba de tu sitio y hace un envio completo con una llave sk_test_ y un monto chico, antes de dejarla cobrando de verdad.

Necesitas: WordPress 6.2 o superior, Gravity Forms 2.5 o superior con licencia activa, PHP 8.0 o superior y HTTPS.

Como se instala

1. Descarga el ZIP y subilo desde Plugins → Anadir nuevo → Subir plugin. Gravity Forms tiene que estar activo.
2. Anda a Formularios → Configuracion → ROKI Connect y pega tus llaves: sk_test_ para probar, sk_live_ para cobrar.
3. Copia la URL del webhook que muestra esa pantalla, registrala en el portal de ROKI y pega aca el secreto de firma.
4. Asegurate de que el formulario tenga al menos un campo de tipo producto: de ahi sale el monto.
5. En el formulario, anda a Configuracion → ROKI Connect → Anadir nuevo, elegi de donde sale el monto y guarda.
6. Hace un envio de prueba con una llave de sandbox antes de publicarlo.

Que hace por vos

De donde sale el monto	Gravity Forms lo calcula desde los campos de producto del formulario, del lado del servidor. No viaja por el navegador, asi que no hay nada que se pueda cambiar desde la consola para pagar menos.
Quien decide que se pago	La entrada se marca pagada con el webhook firmado, no cuando el navegador vuelve. Volver significa que el navegador volvio, no que el dinero se movio.
Reenviar el formulario	No crea un segundo cobro: se manda una llave de idempotencia derivada del contenido y ROKI devuelve el pago que ya existia.
Entregas repetidas	ROKI reintenta hasta que le contesten. Se descartan por el id del evento, con la deduplicacion que Gravity Forms ya trae.
Suscripciones	No las hace, a proposito. Cobrar sin el cliente presente exige guardar su tarjeta, y ese modulo se habilita por comercio en ROKI. Prometerlas sin eso seria fallar en la primera renovacion.

Cobrar la misma lista todos los meses sin crear los enlaces uno por uno. Llenas la hoja, apretas un boton, y cada fila queda con su enlace de pago y su mensaje de WhatsApp listo.

Checkout de ROKI (HPP). Cada persona de la lista recibe su enlace y paga en la pagina de ROKI. Es lo unico que tiene sentido cuando el cobro se manda por WhatsApp.

Version Beta. Probala con una llave sk_test_ y una lista de tres filas antes de mandarle enlaces a ciento veinte personas.

Necesitas: Una cuenta de Google, gratuita alcanza. Nada mas: no hace falta servidor, ni pagina web, ni programador.

Como se instala

1. Descarga el ZIP y abri una hoja de calculo nueva en Google Sheets.
2. Anda a Extensiones → Apps Script, borra lo que haya y pega el contenido de Codigo.gs.
3. Guarda, volve a la hoja y recargala. Aparece un menu nuevo: ROKI.
4. Menu ROKI → 1. Configurar mi llave. Pega tu llave secreta: sk_test_ para probar, sk_live_ para cobrar.
5. Menu ROKI → 2. Preparar esta hoja. Te arma las columnas.
6. Llena Nombre, Telefono, Concepto y Monto, y apreta Crear los enlaces.

Que hace por vos

La llave no vive en una celda	Vive en las propiedades del script, dentro de tu cuenta de Google. Por eso podes compartir la hoja con la secretaria sin compartirle la llave.
Apretar dos veces no duplica	Las filas que ya tienen enlace se saltan, y ademas se manda una llave de idempotencia armada con el mes: dentro del mismo mes, la misma fila devuelve el mismo enlace.
No depende de tu internet	Las llamadas salen de los servidores de Google. Si se cae la conexion del colegio mientras corre, igual termina.
Quien pago y quien no	El boton de estados consulta el listado completo y pinta de verde las filas pagadas. Una consulta para toda la lista, no una por fila.
No cobra solo	Esto no es facturacion recurrente: el cliente sigue abriendo su enlace y pagando. Cobrar sin el cliente presente exige guardar su tarjeta, y ese modulo se habilita por comercio en ROKI.

Cobra matriculas, cursos y certificados con tarjeta dentro de Moodle. Para colegios y universidades que hoy reciben el comprobante de transferencia por correo.

Checkout de ROKI (HPP). El estudiante sale a la pagina de ROKI, paga y vuelve; el acceso se entrega cuando el pago esta confirmado.

Probado de punta a punta en un Moodle 4.5 real: se creo un curso con costo, se apreto Pagar, el cobro se creo en ROKI, el aviso firmado entro por HTTP al webhook y el estudiante quedo matriculado. Tambien se comprobo lo contrario: un aviso que dice "pagado" no entrega el curso si ROKI dice que ese cobro sigue pendiente. Como con cualquier medio de pago, instalalo primero en una copia y hace una matricula con una llave sk_test_ antes de cobrarle a un estudiante.

Necesitas: Moodle 4.5 o superior, con acceso al directorio del sitio. En Moodle alojado por terceros hay que pedirles que lo instalen.

Como se instala

1. Descarga el ZIP y descomprimilo en payment/gateway/ de tu Moodle, de modo que quede payment/gateway/rokiconnect.
2. Entra al sitio como administrador: Moodle detecta el plugin y te pide confirmar la instalacion. Tambien podes hacerlo con php admin/cli/upgrade.php.
3. Anda a Administracion del sitio → Pagos → Cuentas de pago y crea una cuenta, o abri la que ya tengas.
4. En esa cuenta, habilita ROKI Connect y pega tu Llave secreta: sk_test_ para probar, sk_live_ para cobrar de verdad. El entorno lo decide el prefijo.
5. Copia la URL del webhook que muestra la pantalla de ajustes del plugin, registrala en el portal de ROKI y pega el Secreto de firma del webhook en la misma cuenta.
6. Poneele costo a un curso y hace una matricula de prueba con una llave de sandbox.

Que hace por vos

El monto incluye el recargo	Moodle permite un recargo por pasarela. Lo que se le cobra al estudiante es el costo con ese recargo aplicado, no el precio pelado del curso.
Si se pierde un aviso	Una tarea revisa cada quince minutos los cobros pendientes de las ultimas 24 horas y le pregunta a ROKI. El estudiante que pago entra igual.
De quien es cada aviso	La referencia lleva el prefijo del sitio y el webhook lo comprueba. Un Moodle de produccion y su copia de prueba sobre la misma cuenta de ROKI no se entregan cursos entre ellos.
Lo que no hace	No da acceso porque el estudiante haya vuelto del checkout. Volver significa que el navegador volvio; el acceso se entrega cuando ROKI confirma el cobro.

Dos nodos que conectan ROKI con todo lo demas que ya usas. En vez de un conector por plataforma, uno que habla con todas: una hoja, un correo, WhatsApp, tu sistema propio.

Enlace de pago (HPP). El nodo crea el cobro y devuelve el enlace; a donde lo mandas despues lo decide tu flujo.

Instalado en un n8n 2.35 real: n8n carga los dos nodos y sus credenciales, el boton de probar la llave funciona, y un flujo con el nodo se guardo, se ejecuto y dejo el cobro creado en ROKI. Como con cualquier medio de pago, armalo primero con una llave sk_test_ y hace un cobro de prueba antes de dejarlo trabajando con plata de verdad.

Necesitas: Un n8n propio o en la nube, con permiso para instalar nodos de la comunidad. Para el disparador, que tu n8n sea alcanzable desde internet.

Como se instala

1. En tu n8n, anda a Settings → Community nodes → Install y pone n8n-nodes-roki-connect. Si tu n8n no permite nodos de la comunidad, descarga el ZIP y copialo en ~/.n8n/custom/.
2. Crea una credencial ROKI Connect API y pega tu llave secreta. El entorno lo decide el prefijo: sk_test_ prueba y sk_live_ cobra. Apreta Probar antes de guardar.
3. Agrega el nodo ROKI Connect a tu flujo y elegi Crear Enlace De Pago. El monto va en lempiras con decimales, nunca en centavos.
4. Para escuchar los pagos, agrega el nodo ROKI Connect Trigger. Copia su URL de prueba y registrala en el portal de ROKI como webhook de sandbox; cuando actives el flujo, copia la de produccion y registrala como webhook de produccion.
5. Crea una credencial ROKI Connect Webhook con el secreto de firma que te devuelva el portal. Va aparte de la llave a proposito: un flujo que solo escucha no tiene por que ver la llave con la que se cobra.
6. Hace un cobro de prueba con una llave de sandbox y mira que el flujo arranque solo.

Que hace por vos

Lo que hace el nodo de acciones	Crear el enlace de pago, consultar, listar con filtros, anular y reembolsar.
Reintentar no cobra dos veces	La llave de idempotencia sale del contenido del cobro. Si n8n reintenta el nodo, ROKI devuelve el mismo pago; si cambia el monto, crea uno nuevo.
El disparador descarta lo repetido	ROKI reintenta cuando duda si recibiste el aviso. Sin descartarlo, el mismo pago arranca tu flujo dos veces: dos correos, dos facturas, dos despachos.
Lo que no hace	No registra el webhook por vos: ROKI no tiene una ruta para eso. Es el unico paso manual, y es una sola vez por entorno.

Cada instalacion de B1 esta personalizada y se integra por Service Layer. Se arma contra un cliente concreto, junto con su socio implementador.

Que tenes que habilitar de tu lado →

Enlace de pago sobre la factura y conciliacion del cobro contra ella.

Que tenes que habilitar de tu lado →

Enlace de pago desde la factura, con el cobro registrado de vuelta cuando llega el webhook.

Que tenes que habilitar de tu lado →

Publicar en AppExchange exige acuerdo de socio y una revision de seguridad larga. Se evalua cuando haya un cliente que lo pida por nombre.

Que tenes que habilitar de tu lado →