Esta es la documentación oficial del Culqi Integración Pagos Diferidos. Esta pasarela de pago te permite autorizar un pagos que aparecerá como “congelado” en la cuenta del cliente. Esto con la finalidad de dar tiempo al comercio de verificar stock o existencias de los productos pedidos para luego proceder a capturar el pago con un click.
Indice
- Requerimientos
- Ajustes
- Carrito de compras
- Especificar productos
- Pedidos Woocommerce
- Notificaciones vía Email en Woocommerce
- Detalle del pago
Requerimientos
- PHP 5.6 o superior.
- Credenciales de Culqi : https://www.culqi.com/
- Plugin gratuito de Culqi Integración : https://wordpress.org/plugins/culqi-full-integration/
Ajustes
Una ve activada la licencia del plugin, aparecerá una seccíon de diferos en el menu de FullCulqi.
- Puedes definir el comportamiento del plugin, si deseas que toda la tienda tenga pagos diferidos o deseas especificar que productos deben ser considerados como pago diferido.
- Si en el paso de arriba elegiste que vas a especificar los productos, tienes la posibilidad de decidir si en el carrito pueden convivir ambos tipos de productos (productos con pagos diferidos y productos sin pagos diferidos). Explicaremos este comportamiento en el siguiente punto “carrito de compras”.
Carrito de Compras
- No conviven: cada vez que un producto cualquiera es subido al carrito, el plugin verifica si dentro del carrito hay del mismo tipo pues la prioridad lo tiene el producto que se va a agregar en ese momento. Ejemplo1: subimos un producto con pago diferido, si en el carrito hay productos no diferidos, entonces el plugin vacea el carrito y mete este nuevo producto con pago diferido. Ejemplo2: subimos un producto sin pago diferido, si en el carrito hay productos con pago diferido, entonces el plugin vacea el carrito y mete este nuevo producto sin pago diferido.
- Sí conviven: aquí no hay problema y no se verifica nada, pues está permitido que ambos productos (con pago diferido y sin pago diferido) convivan.
Especificar productos con pagos diferidos.
Debes ir a crear producto o editar alguno y verás un checkbox para seleccionar si consideras que ese producto tendrá pago diferido.
En producto simple
En producto variable
Pedidos de Woocommerce
Una vez hecho el pedido como pago diferido aparecerá un nuevo estado llamado “Diferido” el cual habilitará a la derecha un botón (en la sección de acciones) para que el comercio pueda capturar el pago con un sólo click
Además dentro del detalle del pedido, también podrá usar la opción de capturar el pedido dentro de la sección de acciones.
Acerca del log de pedidos, aparecerá una nueva fila donde especificará que este pedido se trata de un pago diferido.
Notificaciones vía Email en Woocommerce
Puedes administrar estas notificaciones en la sección de email dentro de Woocommerce
Detalle del pago
Si vamos al detalle del pago dentro de la sección de pagos de FullCulqi, podrás también capturar el pedido con un enlace al lado del estado.
Webhooks
| Evento | URL |
|---|---|
| charge.capture.failed | http://yoursite.com/wc-api/fullculqi_df_capture/ |
| charge.capture.succeeded | http://yoursite.com/wc-api/fullculqi_df_capture/ |
| charge.expired | http://yoursite.com/wc-api/fullculqi_df_expire/ |
Los 2 primeros eventos son opcionales, es por sí capturas el pago desde el panel de Culqi y no desde la web del comercio, entonces el webhook avisará al comercio que el pago fue capturado y cambiará el estado
El 3er evento sucede cuando el pago diferido a expirado, es decir cuando pasan los 4 días y no hubo ninguna captura. Entonces el webhook avisará al comercio y el plugin colocará ese pedido en “expirado”.
Debes entrar a tu panel de Culqi e ir a Eventos > Webhooks y se abrirá un popup donde debes elegir el evento y poner la URL donde ese evento notificará.
Compatibilidad con otros plugins
Es compatible con el plugin de Culqi Pago con un Click
Es compatible con el plugin de botones y aparecerá la opción “capturar” en las opciones.
Notas Importantes
- Una vez sea autorizado el pago, el comercio tiene 4 días para capturar el pago, sino expirará.
Help Links
How install a plugin? How activate/deactivate a license? How migrate the license to another domain?
