Payphone para PrestaShop:
Plugin de pagos

📎¿Qué es el Módulo Payphone para PrestaShop?

El plugin de Payphone para PrestaShop es una extensión que permite integrar nuestro gateway de pagos directamente en tu tienda online. Una vez instalado, tus clientes podrán pagar usando una gran variedad de métodos, y tú podrás gestionar todos los pagos desde tu cuenta Payphone Business.

Integra Payphone en tu tienda PrestaShop y ofrece a tus clientes una experiencia de pago ágil, segura y multifuncional. Empieza a cobrar de inmediato con un plugin fácil de configurar y repleto de ventajas.

✨ ¿Por Qué Payphone es Genial para tu Tienda?

  1. Integración Instantánea: ¡Conectar Payphone es cuestión de minutos! Empieza a cobrar sin complicaciones.
  2. Pagos a la Medida de tus Clientes: Tarjetas de crédito/débito, saldo Payphone... ¡y más opciones en el futuro! Dale a tus clientes la libertad de elegir cómo pagar.
  3. Seguridad de Alto Nivel: Tus transacciones y la información de tus clientes están protegidas con la tecnología más avanzada. ¡Compra con confianza!
  4. Administración Sencilla: Olvídate del papeleo. Gestiona todos tus pagos desde un solo lugar: tu panel de Payphone Business.
  5. Siempre a la Vanguardia: Payphone está en constante evolución, ofreciéndote nuevas funcionalidades y mejoras para tu negocio.

⚙️¿Cómo Funciona el Módulo de Payphone en tu Tienda PrestaShop?

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

  1. 1. 🔧 Instalación y Configuración
    • Descarga el modulo de PrestaShop directamente desde esta guia y súbelo manualmente.
    • Haz clic en "Instalar" y luego en "Activar" para habilitar el módulo.
    • Dirígete a la sección de "Módulos" en tu panel de PrestaShop y busca "Payphone".
    • Configura los parámetros esenciales: Token de autenticación y StoreID
  3. 2. 🛒 Proceso de Compra del Cliente
    • El cliente navega, agrega productos al carrito y procede al checkout.
    • En la sección de métodos de pago, selecciona Payphone.
  5. 3. 🔐 Validación y Redirección
    • El plugin genera una solicitud de pago según el método:
    • 🔗 Redirección externa (Botón de pago)
    • 🧾 Cajita de pago incrustada (formulario en la misma página)
  7. 4. 🔄 Procesamiento del Pago
    • El plugin se comunica con la API de Payphone.
    • Si el pago es exitoso, se recibe una confirmación con los datos de la transacción.
    • Si falla, el usuario verá el mensaje de error correspondiente.
  9. 5. 📬 Actualización del Pedido
    • PrestaShop actualiza automáticamente el pedido a "Pago con Payphone aprobado" si el pago fue aprobado.
    • Los detalles cruciales del pago se guardan de forma segura en la información del pedido.
    • Se envía una confirmación por correo al cliente.
  11. 6. 📊 Backoffice y Reportes
  12. Desde tu panel de administración podrás:
    • Ver todas las ventas en la sección de pedidos de PrestaShop.
    • Revisar los detalles de pago en la plataforma Payphone Business.

⚠️ ¡Ojo con esto! (Importante sobre el Reverso Automático) ⏪

Imagina que un pago se realiza, pero por alguna razón, tu tienda no lo registra correctamente en los primeros 5 minutos. Para evitar problemas como cobros duplicados o pedidos incompletos, Payphone automáticamente cancelará (reversará) ese pago.

En resumen: Si el PrestaShop no confirma el pago a tiempo, Payphone lo anula para proteger tanto a tu negocio como a tus clientes.

¡Asegúrate de que tu sistema esté configurado correctamente!

🧐 Antes de Empezar: (Requisitos que Debes Cumplir)

Asegúrate de tener todo listo para una integración sin contratiempos:

  1. 🌐 Plataforma Web: Este plugin es exclusivo para sitios web con PrestaShop.
  2. 🔒 Dominio Seguro (HTTPS): Para tu tienda en producción, es indispensable un certificado SSL activo (la dirección de tu web debe empezar con https://). Para pruebas locales, puedes usar http://localhost.
    • ¡Importante! El plugin de Payphone se conecta directamente al dominio que configures en tu cuenta de Payphone.
    • Solo funcionará en ese sitio web específico.
    • Si intentas usarlo en otro dominio, el plugin mostrará un error.
  4. 🏢 Cuenta Payphone Business Activa: Necesitas una cuenta en Payphone Business. ¡Regístrate si aún no lo has hecho!
  5. 👨‍💻 Usuario Desarrollador en Payphone Business: Dentro de tu cuenta, crea un usuario con el rol de "Desarrollador". Él será quien gestione la configuración técnica.
  6. 💻 Entorno de Desarrollo: Asegúrate de tener un espacio para probar la integración, con:
    • Conocimiento y funcionamiento de PrestaShop.
    • Un navegador web actualizado.
  8. 🔑 ¡Tus Credenciales! Desde la plataforma para desarrolladores de Payphone, debes:
    • Crear una nueva "Aplicación".
    • Obtener tu TOKEN de autenticación (Bearer Token) y el STORE ID asociado a tu negocio.
    • ¡Estos son como las llaves de acceso! 🔑

Próximos pasos

A continuación, profundizaremos en cada uno de estos pasos.

🔑Configuración del Ambiente y Obtención de Credenciales

¡Prepara tu plataforma para recibir pagos de forma segura, fácil y eficiente con Payphone! 🛒💳 Sigue estos pasos y empieza a procesar transacciones en minutos:

🚀 Lo primero es configurar tu ambiente

Para que Payphone funcione correctamente, necesitas establecer una conexión segura entre tu sistema y nuestra plataforma.

Esto incluye obtener dos credenciales clave:

Token y StoreID


🛠️ ¿Cómo hacerlo?

  1. Configura tu API. Desde tu cuenta de Payphone Developer asegúrate de haber creado una aplicación de tipo: "WEB"
  2. Al elegir aplicación de tipo "WEB", se requerirá completar dos campos nuevos: Dominio Web y URL de Respuesta.
  3. Obtén tus credenciales. Estos datos son esenciales para autenticarte con Payphone. Encuéntralos al configurar tu aplicación.
  4. Establece tu entorno de desarrollo y pruebas. Esto te permitirá realizar simulaciones antes de pasar a la producción.

🎯 ¿Por qué es importante?

  1. Seguridad: Tus transacciones estarán encriptadas y protegidas contra accesos no autorizados.
  2. Personalización: Adapta los métodos de pago según las necesidades de tu negocio.
  3. Funcionalidad: Garantiza que los pagos se procesen correctamente.


✨ ¡Comienza ahora!

Haz clic en el siguiente botón, sigue las instrucciones para obtener tus credenciales:


📑 Configuración de Ambiente y Obtención de Credenciales


⚠️NOTA:

👉 Sin esta configuración, no podrás procesar pagos a través de nuestra plataforma.

‍🛠️Guía de Integración: Plugin de Payphone para PrestaShop

¡Felicidades! Ya tienes tu aplicación Payphone lista. Ahora, vamos a conectar tu tienda PrestaShop con nuestro poderoso gateway de pagos.

Sigue estos sencillos pasos y prepárate para recibir pagos de forma fluida y segura.

🧩 Paso 1: Instalación del Plugin de Payphone en PrestaShop

  1. Accede a tu Panel de Control de PrestaShop: Ingresa a la administración de tu tienda PrestaShop. ¡Este es tu centro de operaciones!
  2. Navega a la Sección de Módulos: En el menú lateral, busca y haz clic en la sección "Módulos"‍
  3. Abre el "Administrador de Módulos": Dentro de la sección de "Módulos", localiza y haz clic en "Administrador de Módulos"
  4. ¡Sube el Plugin Payphone! En la parte superior derecha, encontrarás el botón "Subir un módulo". Haz clic en él.
  5. Selecciona el Archivo del Plugin: Una ventana se abrirá para que puedas seleccionar el archivo .ZIP del plugin de Payphone que descargaste previamente desde tu dispositivo. ¡Encuéntralo y haz clic en "Abrir"!
  6. Instálalo y espera la confirmación de instalación exitosa.
¿Necesitas el Módulo Payphone? ¡Descárgalo aquí! 👇


PrestaShop v8+
PrestaShop v8+ Box


✅ ¡Una vez que la barra de carga se complete, el plugin estará instalado!

🔑 Paso 2: Configurando tus Credenciales de Payphone en PrestaShop

  1. Regresa a la Sección de Módulos: Si no estás allí, dirígete nuevamente a la sección "Módulos" en tu panel de administración de PrestaShop.
  2. Encuentra el Módulo Payphone y ¡Configúralo!: Busca el módulo de "Payphone" en la lista de módulos instalados. Una vez que lo encuentres, haz clic en el botón "Configurar" que aparece junto a él.

Ingresa tus credenciales

  • Token: Copia y pega el token generado en tu cuenta de Payphone Developer. Este es el identificador seguro que permite la comunicación entre tu tienda y Payphone.
  • StoreID: Coloca el ID de la tienda configurada en Payphone. Si tienes una sola tienda, puedes dejar este campo vacío y se tomará la predeterminada.

‼️ ¡Un Dato Importante! Al abrir esta página de configuración, verás tu URL de respuesta. ¡Cópiala y pégala al crear tu aplicación en Payphone Developer! Es crucial para que Payphone sepa dónde informar sobre los pagos.

💡 ¿Te saltaste el paso de las credenciales?

¡No te preocupes! 🔑 Ve directamente a la sección Configuración de Ambiente y Obtención de Credenciales aqui encuentras la guia para obtener tu Token y StoreID.

Una vez que guardes los cambios, ¡tu modulo estará listo para procesar pagos!🏆

🛍️Interfaz del Plugin Payphone

Hemos diseñado la interfaz del plugin para que sea intuitiva y visualmente atractiva, integrándose perfectamente con el diseño de tu tienda PrestaShop. ¡Una experiencia de pago fluida para tus clientes!

Aquí te mostramos cómo se verá el resultado final:

PrestaShop v8+ (Botón de Pago por Redirección)

  • El cliente será redirigido a la pasarela segura de Payphone para completar el pago.

PrestaShop v8+ Box (Cajita de Pagos Integrada)

  • Un formulario se incrustará directamente en la página de checkout, permitiendo pagar sin salir del sitio. (Ideal para una experiencia más integrada)

¡Y eso es todo! Con estos sencillos pasos, has integrado Payphone en tu tienda PrestaShop y estás listo para ofrecer a tus clientes una experiencia de pago moderna, segura y con múltiples opciones.  🚀

🎞️ Video Tutorial

En el siguiente video puedes ver como en pocos minutos se puede integrar nuestro plugin

🔰Pruebas y paso a producción

En Payphone, tienes el control total de tu integración: tú decides cuándo probar y cuándo lanzar. No necesitas pasar por procesos de certificación, ni depender de terceros para poner tu aplicación en línea. Solo integras, pruebas y lanzas. Así de simple.

Payphone pone a tu disposición dos entornos listos para usar:


1. 🧪 Entorno de PRUEBAS

Espacio seguro y controlado para el desarrollo, integración y validación de tu aplicación. Aquí puedes realizar todas las pruebas necesarias sin afectar a usuarios reales ni realizar cobros reales.

  • Todas las transacciones se aprueban.
  • No se conecta con entidades bancarias.
  • Puedes usar datos reales (sin cobro) o datos ficticios válidos.
  • Compatible con herramientas como Postman o curl para pruebas automatizadas.

Probadores en App Payphone

Invita usuarios personales de Payphone como “probadores” para simular pagos reales desde la app. Ideal para validar la experiencia completa del cliente.


2. 🖥️ Entorno de PRODUCCIÓN

Ambiente en el que tus usuarios finales realizarán pagos reales. Todas las transacciones aquí son efectivas y se procesan a través de la red bancaria.

  • El dinero se transfiere directamente a tu cuenta Payphone.
  • Todas las transacciones se reflejan en tiempo real.


📓 Información detallada

Consulta la guía detallada sobre cómo usar ambos entornos, con ejemplos, recomendaciones técnicas y configuraciones paso a paso:


📑Guia Entorno de Pruebas y Produccion


⚠️ Consideraciones importantes

  • Realiza pruebas exhaustivas antes de pasar a producción.
  • En entorno de producción, usa únicamente datos reales y verificados.
  • Utiliza herramientas de visualización:
    • En Pruebas: revisa transacciones en Payphone Developer > Probadores> Transacciones.
    • En Producción: consulta tu historial en Payphone Business > Ventas.
  • Nuestro sistema tiene estrictos protocolos de seguridad: asegúrate de cumplir con las normas para evitar rechazos o bloqueos.

Una vez que tu aplicación esté en producción, el proceso estará completo.
¡Felicidades por integrar el plugin de Payphone para PrestaShop!

↩️Reverso de Transacciones

Este proceso permite deshacer una transacción que ya ha sido procesada, devolviendo los fondos al cliente.

Para gestionar reverso o anulación de transacciones, es necesario contar con el transactionID o el clientTransactionID. Estos identificadores son cruciales para localizar y manipular la transacción específica.


🗂️ Casos de uso

El método de reverso es útil en diferentes situaciones:

  • Cuando se generó transacciones erróneas.
  • Cuando el cliente realiza solicitudes de reembolso.
  • Cuando su plataforma no puede confirmar el estado de la transacción.
  • Por razones de seguridad, cuando un pago necesita ser reversado.

↩️Reverso desde payphone business

Para obtener una explicación detallada sobre el proceso de reversos directamente desde la plataforma Payphone Business, consulte nuestra documentación.


📑 GUIA DE REVERSO PAYPHONE


⚠️Consideraciones

Es crucial tener en cuenta la siguiente restricción temporal para los reversos de transacciones:

  • Los reversos solo pueden ejecutarse el mismo día de la transacción original.
  • El período de reversión está limitado hasta las 20:00 del día en que se realizó la transacción.