https://github.com/ebiggio/prestashop-mach-pay
Módulo de pago para PrestaShop 1.7 que permite realizar cobros con MACH.
https://github.com/ebiggio/prestashop-mach-pay
mach-pay prestashop-1-7 prestashop-free-module prestashop-module prestashop-payment
Last synced: 3 months ago
JSON representation
Módulo de pago para PrestaShop 1.7 que permite realizar cobros con MACH.
- Host: GitHub
- URL: https://github.com/ebiggio/prestashop-mach-pay
- Owner: ebiggio
- License: gpl-3.0
- Created: 2023-01-11T06:48:31.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-12T23:29:52.000Z (over 1 year ago)
- Last Synced: 2025-01-11T06:29:21.356Z (4 months ago)
- Topics: mach-pay, prestashop-1-7, prestashop-free-module, prestashop-module, prestashop-payment
- Language: PHP
- Homepage:
- Size: 88.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MACH Pay para PrestaShop 1.7
Módulo de pago para PrestaShop que permite realizar pagos con la aplicación MACH.
## Requerimientos
* Extensión `cURL` de PHP
## Configuración
* Guardar todo el contenido de este repositorio en una carpeta de nombre `machpay`, y luego comprimir dicha carpeta en un archivo `zip`
* Instalar el módulo mediante la función "Upload module" del back office de PrestaShop, e ingresar a su configuración
* Definir si se desea utilizar el módulo en el ambiente de sandbox o producción, ingresando la `API key` según corresponda
* Puedes conseguir tu `API key` en el [sitio oficial de MACH Pay](https://pay.somosmach.com/)
* Seleccionar si se deberán confirmar los pagos una vez que se reciba la notificación de un pago completado. Esta configuración depende de cómo esté definido el negocio en MACH Pay:
* Si la captura de pagos se realiza de forma manual, esta opción debe estar activa
* En caso de que la captura de pagos sea automática, esta opción se debe apagar, ya que de lo contrario el módulo intentará confirmar el pago mediante API, recibiendo un error al ya estar el pago confirmado
* Es importante tener presente que cuando la captura es manual, **un pago completado que no es confirmado generará una reversa transcurridos 5 minutos**
* (Opcional) Configurar las URLs base de la API de MACH Pay. Estas no deberían cambiar de las que sugiere por defecto el módulo al instalarse, pero en caso de ser necesario, se deben ingresar **sin** trailing slash (`/`)
* Configurar como webhook la URL que despliega la configuración del módulo en el [back office de MACH Pay](https://pay.somosmach.com/settings/webhooks). Esta URL sólo se muestra como referencia en el formulario para un fácil *copy/paste*; su valor no puede ser cambiado
* (Opcional) Especificar las IPs autorizadas a invocar el webhook. Estas IPs corresponden a los servidores de MACH PAy desde donde se despachan los eventos. Al igual que con las URLs base de la API, la lista que se presenta al instalar el módulo no debería cambiar, pero si lo deseas, puedes cambiar estos valores ingresando IPs separadas por comas
## Ideas de mejoras para un *futuro cercano*
* Permitir especificar los estados a los que debe cambiar un pedido cuando se recibe un evento de pago completado, fallido, expirado y reembolso completado. Actualmente, el módulo usa los valores de configuración de la tienda `PS_OS_PAYMENT`, `PS_OS_ERROR`, `PS_OS_CANCELED`, `PS_OS_REFUND`. Estos cambios (a excepción del que ocurre cuando se completa un pago) a su vez debiesen ser opcionales