El módulo de PrestaShop es la solución perfecta para procesar pagos con tarjeta de crédito y débito en tu tienda en línea. Con nuestro tutorial, podrás activar y poner en funcionamiento tu botón de pago en pocos minutos. Además de aceptar tarjetas bancarias, también te permitirá recibir tarjetas de regalo y saldo de Payphone de tus clientes a través de nuestra aplicación.
Steps to integrate the module
Para comenzar a recibir pagos con nuestro gateway, solo necesitas seguir estos sencillos pasos:
Crea tu cuenta Payphone Business y configúrala.
Instala el módulo de Payphone en tu sitio de PrestaShop.
Configura el módulo.
Empieza a cobrar de manera rápida y segura.
Environment configuration
To configure the module you must meet certain requirements that we divide into two categories: Business Requirements and Development Requirements.
Requisitos Comerciales:
El establecimiento que va a recibir los pagos tiene que estar registrado en Payphone Business. Para iniciar el registro puedes hacer click aquí.
Con la tienda activa y lista para transaccionar, debes crear un usuario de tipo “desarrollador“, el cual te explicaremos más adelante.
Requisitos de Desarrollo:
Debes configurar en nuestro sitio web para desarrolladores «Payphone Developer» tu ambiente de desarrollo en donde podrás obtener todas tu token de autenticación con el que te identificas en los servicios de Payphone.
Create developer user
Inicia sesión en tu cuenta de Payphone Business con tu RUC, correo y contraseña.
Go to the "Users" section and select "Create User".
Complete the form by entering all the required data and make sure to select the "Developer" role.
With the developer user created, you are ready to start the implementation.
Payphone Developer
Setting up the development environment at Payphone allows you to manage and monitor all transactions made through the platform efficiently. Follow these steps to get started:
Las aplicaciones de desarrollo de Payphone te permiten configurar parámetros de conexión, usuarios de prueba y gestionar tu entorno (pruebas y producción). Además, te proporcionan las credenciales necesarias para la autenticación, como el token y el StoreID.
Start Creating the Application To begin, click on the "+ Add" button located at the top of the page.
Completa el Formulario de Creación Se abrirá un formulario en el que deberás ingresar la información de tu aplicación. A continuación, se detallan los campos que debes completar:
Nombre: Define un nombre que identifique claramente tu aplicación.
Descripción: Añade una breve descripción de la funcionalidad o propósito de tu aplicación.
Categoría: Selecciona la categoría que mejor corresponda a tu perfil de negocio.
Plataforma de Desarrollo: Elige la plataforma donde está desarrollada tu aplicación. Si no aparece la opción exacta, selecciona la más similar.
Tipo de Aplicación: Para integrar el botón de pagos, asegúrate de seleccionar el tipo WEB.
Dominio Web: Introduce la URL de tu sitio web. Es importante solo el dominio registrado puede acceder al botón de pago de Payphone. Si intentas abrir la «cajita de pagos» desde otro dominio, el acceso será bloqueado.
Response URL: Provides the URL to which the user will be redirected once the transaction is completed. This URL will contain the necessary parameters to obtain the complete details of the transaction.
Para el plugin de PrestaShop, la URL de respuesta se muestra en la configuración del módulo. Consulta la imagen (img-9) para más detalles.
Después de completar todos los campos, presiona el botón Guardar.
Una vez que hayas completado estos pasos, estarás listo para la configuración final.
Configura tu botón de pago Payphone en PrestaShop
Accede a los módulos de PrestaShop: Dirígete a la sección de «Módulos» en tu panel de administración.
Busca el módulo PayPhone: Localiza el módulo que acabas de instalar y haz clic en «Configurar».
Ingresa tus credenciales:
Token: Copia y pega el token que obtuviste en PayPhone Developer.
StoreID: Si tienes varias tiendas, indica el ID de la tienda que deseas configurar. Si solo tienes una, puedes dejarlo en blanco.
Estos datos se obtiene desde la plataforma de Payphone Developer, en la sección Configuración, pestaña Credenciales como se muestran en la imagen anterior (img-5)
NOTA: al abrir la configuración del plugin de PayPhone, podrás verificar tu URL de respuesta, que es necesaria para crear la aplicación en Payphone Developer.
Una vez que guardes los cambios, tu plugin estará listo para realizar transacciones.
Interfaz del Plugin Payphone
La interfaz está diseñada para ser intuitiva, facilitando la gestión de pagos y la experiencia del usuario. Verás un diseño limpio y moderno que se integra perfectamente con tu tienda.
A continuación, te mostramos cómo se verá el resultado del plugin:
PrestaShop v1.7 y v8. (Botón por redirección)
PrestaShop v8 Payphone Box (Cajita de Pagos)
Testing and move to Production
Como te hemos mencionado anteriormente, en Payphone tienes el control total sobre el proceso. Eres tú quien decide cómo ejecutar las pruebas y cuándo pasar a producción. No necesitas ningún proceso de certificación, y puedes publicar tu aplicación de manera independiente. A continuación, te ofrecemos una guía para facilitarte este proceso.
Tu aplicación, creada en la página de Payphone Developer, cuenta con dos ambientes preestablecidos: “PRUEBAS” y “PRODUCCIÓN”. Al acceder a la configuración de tu aplicación en nuestro sitio de Developers, podrás seleccionar el ambiente que desees utilizar.
Ambiente de Pruebas: Un entorno seguro para desarrollar y probar tu aplicación sin afectar a tus usuarios.
En el ambiente de pruebas, todas tus transacciones serán aprobadas, pero no se conectarán a ningún procesador bancario. Esto significa que puedes utilizar tus tarjetas (Visa o Mastercard válidas) sin que se realice ningún cobro real.
Ambiente de Producción: El entorno real donde tus clientes realizarán pagos. Asegúrate de haber realizado todas las pruebas necesarias antes de activar este ambiente.
En el ambiente de producción, las transacciones se conectan efectivamente al sistema bancario, lo que implica que las operaciones son reales y tu botón de pago estará activo.
Una vez que tu aplicación esté en producción, el proceso estará completo.