Crea el usuario desarrollador, configura la aplicación en Payphone y obtén el Token de acceso y el Store ID para conectar la integración en Brain Studio.
La necesitas antes de conectar Payphone en Marketplace, cuando Brain Studio te solicita estas dos credenciales:
Token de acceso
Store ID
Payphone utiliza dos portales distintos durante este proceso:
Portal Business: donde gestionas usuarios y tiendas
Portal Developer: donde creas la aplicación y obtienes el Token de acceso
El Token de acceso y el Store ID solo están disponibles después de que Payphone apruebe la solicitud de empresa. No podrás completar la conexión en Brain Studio hasta que esa aprobación ocurra.
Al finalizar esta guía tendrás el Token de acceso y el Store ID listos para conectar Payphone en Brain Studio.
Al instalar la integración en Brain Studio completarás un modal de 3 pasos: credenciales (Token e ID de tienda), entorno (prueba o producción) e IVA aplicado. La moneda USD se refleja en la pestaña Avanzado del nodo.
Entra al portal de Payphone Business con tu cuenta de comercio.Desde aquí vas a:
crear el usuario desarrollador
asignarlo a la tienda que usarás en la integración
2
Crear un usuario desarrollador
En el menú lateral del portal Business, ve a Administración → Usuarios y crea un nuevo usuario con perfil de desarrollo.Completa al menos:
Nombre
Apellidos
Correo electrónico
Contraseña
Tienda asignada
El usuario desarrollador debe quedar asignado a la tienda correcta. Si no está asignado, no podrás operar correctamente la integración ni obtener el Store ID asociado a esa tienda.
Formulario de creación de usuario en Payphone Business — selecciona el rol Desarrollador y asigna la tienda
3
Ingresar al portal de desarrolladores
Con el usuario desarrollador que acabas de crear, entra al portal de Payphone Developer.Usa este acceso:
Estos valores son obligatorios para la integración con Jelou. Si configuras un dominio o una URL distinta, el checkout no podrá devolver correctamente el estado del pago a Brain Studio.
Formulario de creación de aplicación en Payphone Developer — verifica que el Tipo sea Web y que el Dominio web y la URL de respuesta coincidan exactamente con los valores indicados
6
Crear la solicitud de empresa
En el portal de desarrolladores, ve a Solicitud de compañía.Si todavía no tienes una solicitud creada, genera una nueva e ingresa:
RUC de la empresa
Motivo de la solicitud
Puedes usar un texto como este:
Por favor asignar para integrar link de pago a través de app de terceros.
Modal de solicitud de compañía en Payphone Developer — ingresa el RUC de tu empresa y el motivo antes de guardar
Debes esperar la aprobación de esta solicitud para que el Token de acceso quede disponible. Sin aprobación, no podrás completar la conexión en Brain Studio.
7
Obtener el Token de acceso
Una vez aprobada la solicitud, vuelve al portal de desarrolladores y abre la aplicación que configuraste.Desde ahí podrás copiar el Token de acceso.
Solicitud aprobada en Payphone Developer — haz clic en 'Ver todo el token' para copiar el Token de acceso completo
8
Obtener el Store ID
Dentro del portal de Payphone Developer, en la sección Solicitud de compañía, haz clic en el botón de acción de la solicitud aprobada.Se abrirá el listado de tiendas asociadas. Copia el StoreId de la tienda que asignaste al usuario desarrollador.
Listado de tiendas en Payphone Developer — copia el StoreId de la tienda asignada al usuario desarrollador
Cuando ya tengas el Token de acceso y el Store ID, puedes continuar con la conexión en Brain Studio.
Payphone utiliza las mismas credenciales (Token de acceso y Store ID) para pruebas y producción.
No necesitas generar un token distinto
El entorno se controla desde la configuración de la aplicación en el portal de desarrolladores
Payphone Developer: selector Producción / Prueba
Dentro del portal de Payphone Developer, puedes alternar entre Producción y Prueba usando el selector de entorno en la aplicación.Este cambio afecta cómo se procesan los pagos, pero no cambia las credenciales utilizadas en Brain Studio.
En Brain Studio también defines el entorno al instalar la integración (paso 2 del modal) y en la pestaña Avanzado del nodo. Los tres puntos deben coincidir: instalación, nodo y Payphone Developer.Revisa Conectar en Brain Studio.
Antes de probar o pasar a producción, asegúrate de que el entorno seleccionado en Payphone Developer coincide con el de Brain Studio y con el escenario que estás validando.
Si ya enviaste la solicitud y todavía no puedes ver el Token de acceso:
verifica el estado de la solicitud en el portal de desarrolladores
confirma que el RUC y el motivo fueron ingresados correctamente
revisa que la aplicación tenga configurados el dominio y la URL de respuesta correctos
Si la aprobación tarda más de lo esperado, contacta al soporte de Payphone.
No encuentro el Store ID
El Store ID se obtiene en el portal de Payphone Developer, en la sección Solicitud de compañía.Usa el botón de acción de la solicitud aprobada para ver el listado de tiendas y copia el StoreId de la tienda asignada al usuario desarrollador.
El token no funciona en Marketplace
Verifica que:
la solicitud de empresa ya fue aprobada
copiaste el Token de acceso completo
el Store ID corresponde a la tienda correcta
el usuario desarrollador está asignado a esa tienda
