ROKI Connect para WHMCS
=======================

Cobra con tarjeta las facturas de WHMCS a traves de ROKI Connect.


COMO SE INSTALA
---------------

1. Descomprimi este ZIP y copia las dos carpetas dentro de tu WHMCS, respetando la estructura:

       modules/gateways/rokiconnect.php
       modules/gateways/callback/rokiconnect.php

   Se copian por FTP o SSH, sobre la instalacion que ya tenes. No pisan nada existente.

2. En el panel de WHMCS anda a
       Configuracion > Aplicaciones y servicios > Pasarelas de pago
   (en versiones anteriores: Setup > Payments > Payment Gateways),
   pestana "Ver todas las pasarelas", y activa ROKI Connect.

3. 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 de ROKI.

4. Copia la URL del webhook que muestra esa misma pantalla de configuracion, registrala en el
   portal de ROKI en la pestana Webhooks, y pega aca el secreto de firma que te devuelva.

5. Elegi el entorno que corresponda y guarda.

Proba con una factura chica y una llave sk_test_ antes de dejarlo para tus clientes.


LO QUE HACE
-----------

- El cliente paga en el checkout de ROKI y vuelve a tu WHMCS.
- La factura se marca pagada cuando llega el webhook firmado, no cuando el navegador vuelve.
  Volver significa que el navegador volvio, no que el dinero se movio.
- Reembolsos desde el panel de WHMCS, totales y parciales.
  Si devolves la factura ENTERA se intenta anular primero, que es lo correcto mientras la
  transaccion no haya liquidado: una anulacion no le aparece al cliente en su estado de cuenta.
  Si devolves una PARTE va directo al reembolso, porque una anulacion es siempre por el total y
  devolveria de mas.
- Comision al cliente opcional: ROKI recalcula el total para que a vos te quede el monto de la
  factura.


LO QUE NO HACE, DICHO DE FRENTE
-------------------------------

No cobra renovaciones automaticas. El cliente recibe su factura y paga cada mes entrando al enlace.

La razon es concreta: para cobrar sin el cliente presente hay que guardar su tarjeta, y el modulo
de tarjetas guardadas se habilita por comercio en ROKI. Mientras no este habilitado en tu cuenta,
un modulo que prometiera renovaciones automaticas fallaria en el primer vencimiento - y eso es
peor que no prometerlas.

Si tu cuenta tiene habilitadas las tarjetas guardadas, escribinos: la version con cobro
automatico es un modulo aparte, porque WHMCS decide el tipo de pasarela segun como esta escrito
el archivo y los dos tipos no conviven.


REQUISITOS
----------

- WHMCS 8.0 o superior (probado contra la estructura de modulos de la 8.x y 9.x).
- PHP 7.4 o superior, con cURL.
- WHMCS autoalojado. En WHMCS Cloud no se pueden subir modulos propios.


SOPORTE
-------

https://connect.roki.la
