Guía de configuración de ambiente

📎¿Qué es la configuracion de ambiente?

La configuración del ambiente es el primer paso para integrar tu sistema con los servicios de Payphone. Básicamente, se trata de preparar todo lo necesario para que tu sistema pueda comunicarse de forma segura y eficiente con Payphone, como si construyeras un puente entre ambos.

✅ ¿Por qué es importante configurarlo bien?

1. 🔒 Seguridad: Asegura que toda la información que intercambies con Payphone esté encriptada y protegida, evitando accesos no autorizados.
2. ⚙️ Funcionamiento correcto: Una buena configuración garantiza que las solicitudes que envías a las APIs de Payphone funcionen sin errores y recibas las respuestas esperadas.
3. 🎯 Personalización: Te permite adaptar la integración a las necesidades específicas de tu negocio, como elegir qué métodos de pago ofrecer, configurar tiendas, entre otros.

📘 ¿Qué aprenderás en esta guía?

Con esta guía paso a paso, aprenderás a configurar tu ambiente para la integración de Payphone. Se incluyen detalles clave como:

• Configuración inicial del sistema.
• Obtención de credenciales (tokens y claves API).
• Preparación para realizar transacciones de prueba y producción.

Siguiendo estas instrucciones, podrás implementar una pasarela de pago eficiente y ajustada a las necesidades de tus clientes.

🧰 Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Cuenta de Payphone Business: Necesitas una cuenta activa para gestionar tus tiendas, usuarios y ventas. 👉 Regístrate aquí si aún no la tienes.
• Entorno de desarrollo: Debes contar con un entorno técnico listo para implementar integraciones (como un editor de código y herramientas para hacer pruebas).
• Conocimientos básicos de desarrollo: Es útil estar familiarizado con conceptos como:
• • Solicitudes HTTP
  • Formato JSON
  • Autenticación con tokens o claves API

🥇 PRIMER PASO: Crear un Usuario Desarrollador

Antes de comenzar con la integración, necesitas crear un usuario con el rol de "Desarrollador" en tu cuenta de Payphone Business. Este usuario podrá acceder a las herramientas técnicas y credenciales necesarias.

Cómo crear el usuario:

• Inicia sesión en Payphone Business con tu RUC o CI, correo y contraseña, con tu usuario con rol Administrador.
• Dirígete al menú "Usuarios" y haz clic en "Crear Usuario".

• Completa el formulario ingresando todos los datos requeridos:
• • Nombre, apellidos y correo electrónico del desarrollador.
  • Asigna una contraseña.
  • Selecciona el rol "Desarrollador".
  • Asocia al menos una tienda activa.

☑️ Una vez creado, este usuario podrá acceder a la plataforma de desarrollo de Payphone.

🥈 SEGUNDO PASO: Configurar el Ambiente de Desarrollo

Esta configuración permite que tu sistema se comunique de forma segura y efectiva con los servicios de Payphone.

Sigue estos pasos para comenzar:

1. Acceder a la plataforma para desarrolladores

• Ingresa en Payphone Developer: https://appdeveloper.payphonetodoesposible.com/
• Inicio de Sesión con las credenciales de tu usuario desarrollador (RUC o CI, correo electrónico y contraseña).

2. Crear una nueva aplicación

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 permiten obtener las credenciales (Token y StoreID) necesarias para interactuar con la API.

Pasos:

Haz clic en "+ Agregar" en la parte superior de la pantalla.

Completa el Formulario: 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:
• • WEB: Para integrar Botón de pagos, Cajita de Pagos, Plugin de Wordpress o Prestashop
  • API: Para integrar API Link de pagos o API Sale

👉Al elegir Aplicación de tipo "WEB", se requerirá completar dos nuevos campos .

• Dominio Web: Introduce la URL de tu sitio web. Es importante solo el dominio registrado puede acceder nuestros botónes de pago Payphone. Si intentas abrir 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 los plugin de Wordpress y Prestashop la URL de respuesta se encuentra en la misma configuración del plugin.

☑️ Después de completar todos los campos, presiona el botón Guardar.

🥉TERCER PASO: Obtener las Credenciales (Token y StoreID)

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

• 🪪Accede a la sección "Credenciales": Dirígete al menú superior y selecciona la pestaña "Credenciales".
• 🔐Token y StoreID: En esta sección encontrarás tu Token y tu StoreID. Ambos son necesarios para autenticar tu aplicación con los servicios de Payphone. Puedes copiarlos fácilmente con los botones proporcionados.

🔐Token:

🆔StoreId:

🏁 CUARTO PASO: Entorno de 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.

Entornos disponibles:

Payphone ofrece dos ambientes preestablecidos para tus integraciones:

• 🧪 PRUEBAS
• 🖥️ PRODUCCIÓN

Al seleccionar la configuración de tu aplicación, podrás seleccionar el ambiente que desees utilizar.

🧪 Entorno 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 o puedes usar datos ficticios que cumplan con los requisitos de cada campo.

Puedes utiliza herramientas como Postman o curl para realizar solicitudes a nuestros servicios y verificar las respuestas.

📱 Probadores:

La sección de probadores está diseñada para usuarios de Payphone personal y permite simular pagos desde la aplicación de Payphone. Su configuración es opcional.

¿Cómo funciona?

• ‍Invita a un usuario de Payphone personal: Accede al menú "Probadores" > "Clientes" y registra los números de teléfono de usuarios Payphone.
  
• Confirmación: Recibirán una invitación por correo electrónico a la dirección asociada a su cuenta de Payphone personal.
  
• ¡Probar! Una vez aceptada la invitación, podrán simular pagos desde la app de Payphone y tú podrás ver cómo se procesan.
  

👁️ Visualizar Transacciones en Pruebas:

Si deseas visualizar cualquier transacción realizada durante las pruebas, encontrarás un registro detallado en Payphone Developer.

A continuación, accede a la sección 'Probadores' y finalmente haz clic en 'Transacciones'

🖥️ Entorno de Producción

Este es el entorno donde tus clientes realizarán sus pagos de manera real. Todas las transacciones que se lleven a cabo en este ambiente se conectarán directamente al sistema bancario, lo que significa que el dinero se transferirá de forma efectiva

📌 Recomendaciones:

• Pruebas Finales: Realiza pruebas exhaustivas en el ambiente de producción antes de lanzar la aplicación al público.
  
• Datos del Titular: Utiliza únicamente datos reales (números de tarjeta, datos del cliente vinculado con su banco emisor, etc.) para evitar cualquier inconveniente.
  
• Protocolo de seguridad: Nuestro sistema cuenta con altos niveles de seguridad, por eso es importante utilizar datos correctos para evitar posibles bloqueos.
  

Una vez que tu aplicación esté en producción, el proceso estará completo.

👁️ Visualización de Transacciones en Producción:

Para revisar el historial completo de transacciones en el entorno de producción, dirígete a Payphone business. A continuación, haz clic en la opción 'Ventas'.