Guía de configuración de ambiente

¿Qué es la configuracion de ambiente?

La configuración del ambiente se refiere al proceso de preparar tu sistema para que pueda comunicarse de manera efectiva y segura con los servicios de payphone. Es como construir un puente entre tus sistemas y los de payphone para permitir las transacciones de pago.

¿Por qué es importante?

Seguridad: Asegurar que la conexión entre tus sistemas y payphone sea encriptada y protegida para evitar accesos no autorizados a información confidencial.
Funcionalidad: Configurar correctamente el ambiente garantiza que las solicitudes que envíes a las APIs de payphone sean procesadas correctamente y que recibas las respuestas esperadas.
Personalización: Te permite adaptar la integración de payphone a las necesidades específicas de tu negocio, como configurar los métodos de pago y otras opciones.

Esta guía te ayudará a integrar los servicios de payphone en tu proyecto, desde la configuración inicial hasta la obtención de las credenciales necesarias para realizar transacciones.

Requisitos Previos:

Cuenta de payphone Business: Debe tener una cuenta activa en payphone Business para gestionar tus ventas, tiendas y usuarios. Para iniciar el registro puedes hacer click aquí.
Entorno de desarrollo: Un entorno de desarrollo configurado con las herramientas necesarias para realizar las integraciones
Conocimientos básicos de desarrollo: Familiaridad con conceptos como solicitudes HTTP, JSON, y autenticación.

Creación de Usuario Desarrollador

Una vez que tu tienda esté activa, deberás crear un usuario con rol de "Desarrollador" en payphone Business. Este usuario tendrá acceso a las herramientas y credenciales necesarias para integrar los servicios de payphone.

Proceso para crear usuario

Accede a tu cuenta de payphone Business con tu RUC o CI, correo y contraseña.
Dirígete a la sección "Usuarios" y selecciona "Crear Usuario".

Completa el formulario ingresando todos los datos requeridos (nombre, apellidos, correo), asígnale una contraseña y asegúrate de seleccionar el rol "Desarrollador". No olvides seleccionar al menos una tienda.

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

Configuración del Ambiente de Desarrollo

Configurar el ambiente de desarrollo en payphone te permite preparar tu sistema para que pueda comunicarse de manera efectiva y segura con los servicios de payphone. Sigue estos pasos para comenzar:

Iniciar sesión en payphone Developer

Acceso a payphone Developer: Ingresa a la plataforma de desarrollo de payphone: https://appdeveloper.payphonetodoesposible.com/
Inicio de Sesión: Inicia sesión con las credenciales de tu usuario desarrollador (RUC o CI, correo electrónico y contraseña).

Creación de una 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.

Agregar Nueva Aplicación: Para comenzar, haz clic en el botón "+ Agregar" ubicado en la parte superior de la plataforma.

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 link de pagos o Sale

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

Dominio Web: Introduce la URL de tu sitio web. Es importante solo el dominio registrado puede acceder nuestros botón 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.

La URL de respuesta para los plugin de Wordpress y Prestashop se encuentra en la misma configuración del plugin.

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.

Acceder a la Sección de 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.

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 plataforma de payphone Developer, cuenta con dos ambientes preestablecidos: "PRUEBAS" y "PRODUCCIÓN". Al acceder a la configuración de tu aplicación, 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 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.

Visualización de 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'

Ambiente 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'.