Sabias que...

Con Payphone tu integración es inmediata, todo el proceso lo controlas tú.

Visita payphone.app

Prestashop | Modulo Payphone

¿Cómo funciona el modulo Prestashop?

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.

Pasos para integrar el módulo

Para comenzar a recibir pagos con nuestro gateway, solo necesitas seguir estos sencillos pasos:

  1. Crea tu cuenta Payphone Business y configúrala.
  2. Instala el módulo de Payphone en tu sitio de PrestaShop.
  3. Configura el módulo.
  4. Empieza a cobrar de manera rápida y segura.

Configuración de ambiente

Para configurar el modulo debes cumplir ciertos requisitos que dividimos en dos categorías: Requisitos Comerciales y Requisitos de Desarrollo.

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.

Crear usuario desarrollador

  • Inicia sesión en tu cuenta de Payphone Business con tu RUC, correo y contraseña.
  • Dirígete a la sección «Usuarios» y selecciona «Crear Usuario».
img-1
  • Completa el formulario ingresando todos los datos requeridos y asegúrate de seleccionar el rol «Desarrollador».
img-2

Con el usuario desarrollador creado, estarás listo para iniciar la implementación.

Payphone Developer

Configurar el ambiente de desarrollo en Payphone te permite gestionar y supervisar todas las transacciones realizadas a través de la plataforma de manera eficiente. Sigue estos pasos para comenzar:

1. Iniciar sesión en Payphone Developer

Ingresa a la plataforma https://appdeveloper.payphonetodoesposible.com/ e inicia sesión con las credenciales de tu usuario desarrollador (Ruc, correo y contraseña).

img-3

2. Crear Aplicación Payphone:

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.

Inicia la Creación de la Aplicación
Para comenzar, haz clic en el botón “+ Agregar” ubicado en la parte superior de la página.

img-4

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.
  • URL de Respuesta: Proporciona la URL a la que se redirigirá al usuario una vez finalizada la transacción. En esta URL se adjuntarán los parámetros necesarios para obtener el detalle completo de la transacción realizada.
  • 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.

Obtener Credenciales de Autenticación (Token, StoreID)

Una vez creada tu aplicación, obtendrás las credenciales necesarias para acceder a nuestras APIs.

  • Dirígete al menú superior y selecciona la pestaña Credenciales.
  • Podrás ver el Token y el botón que te lleva al listado de tiendas, donde encontrarás tu StoreID. Ambos cuentan con un botón para copiarlos fácilmente.
img-5

Instalación y configuración

¡Perfecto! Ahora que has creado tu aplicación, podemos comenzar la configuración en PrestaShop. Sigue estos pasos:

  1. Accede a tu panel de PrestaShop.
  2. Dirígete a la sección de «Módulos».
  3. Haz clic en «Administrador de Módulos» (Module Manager).
  4. Selecciona «Subir un módulo» (Upload a module).
  5. Carga el plugin de PayPhone desde tu dispositivo.

Descargas del Módulo PayPhone

img-6
img-7

Una vez que hayas completado estos pasos, estarás listo para la configuración final.

Configura tu botón de pago Payphone en PrestaShop

  1. Accede a los módulos de PrestaShop: Dirígete a la sección de «Módulos» en tu panel de administración.
  2. Busca el módulo PayPhone: Localiza el módulo que acabas de instalar y haz clic en «Configurar».
img-8

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)

img-9

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) 

Pruebas y paso a Producción

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.

¡Felicidades por integrar Payphone en Prestashop!