> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtención de credenciales

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

## ¿Cuándo necesitas esta guía?

La necesitas antes de conectar **Payphone** en Marketplace, cuando Brain Studio te solicita estas dos credenciales:

* **Token de acceso**
* **Store ID**

<Info>
  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
</Info>

<Warning>
  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.
</Warning>

<Check>
  Al finalizar esta guía tendrás el **Token de acceso** y el **Store ID** listos para conectar Payphone en Brain Studio.
</Check>

<Info>
  Al instalar la integración en Brain Studio también deberás completar dos campos adicionales que no provienen de Payphone:

  * **IVA** — ingresa el porcentaje como número entero (ejemplo: `12`)
  * **Moneda** — debe ser `USD`
</Info>

***

## Antes de comenzar

Necesitas:

1. Una **cuenta activa en Payphone Business**
2. Al menos una **tienda activa** en esa cuenta
3. Acceso al portal de desarrolladores de Payphone

Si aún no tienes cuenta, puedes crearla aquí:

* [Crear cuenta en Payphone](https://appstore.payphonetodoesposible.com/registerini)

Portales que usarás durante esta guía:

* [Payphone Business](https://appstore.payphonetodoesposible.com/login)
* [Payphone Developer](https://appdeveloper.payphonetodoesposible.com/login)

***

## Pasos para obtener las credenciales

<Steps>
  <Step title="Ingresar a Payphone Business">
    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
  </Step>

  <Step title="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**

    <Warning>
      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.
    </Warning>

    <Frame caption="Formulario de creación de usuario en Payphone Business — selecciona el rol Desarrollador y asigna la tienda">
      <img src="https://mintcdn.com/jelouai/N-faBULcr0WC2nPA/assets/images/integraciones/pagos/payphone-crear-usuario-desarrollador.png?fit=max&auto=format&n=N-faBULcr0WC2nPA&q=85&s=bed6b03027660d2134c5078682ecea05" alt="Formulario de nuevo usuario en Payphone Business con el rol Desarrollador seleccionado y la tienda asignada" width="1024" height="469" data-path="assets/images/integraciones/pagos/payphone-crear-usuario-desarrollador.png" />
    </Frame>
  </Step>

  <Step title="Ingresar al portal de desarrolladores">
    Con el usuario desarrollador que acabas de crear, entra al portal de **Payphone Developer**.

    Usa este acceso:

    * [Ingresar al portal Developer](https://appdeveloper.payphonetodoesposible.com/login)

    <Info>
      Este portal es independiente de Payphone Business. Debes iniciar sesión con el **usuario desarrollador**, no con la cuenta principal del comercio.
    </Info>
  </Step>

  <Step title="Crear una aplicación">
    Dentro del portal de desarrolladores, crea una nueva aplicación.

    Completa la configuración básica:

    * **Nombre de la aplicación**
    * **Descripción**
    * **Categorías**
    * **Plataforma de desarrollo**: puedes seleccionar **Java**
    * **Tipo de aplicación**: **Web**

    <Tip>
      Aunque el campo de plataforma de desarrollo esté presente, para esta integración lo importante es que el tipo de aplicación sea **Web**.
    </Tip>
  </Step>

  <Step title="Configurar dominio y URL de respuesta">
    En la configuración de la aplicación, ingresa estos valores exactamente como se muestran:

    | Campo                | Valor                                                           |
    | -------------------- | --------------------------------------------------------------- |
    | **Dominio web**      | `https://chat-payments.jelou.ai/`                               |
    | **URL de respuesta** | `https://chat-payments.jelou.ai/link-webhook?provider=PAYPHONE` |

    <Warning>
      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.
    </Warning>

    <Frame caption="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">
      <img src="https://mintcdn.com/jelouai/N-faBULcr0WC2nPA/assets/images/integraciones/pagos/payphone-crear-aplicacion.png?fit=max&auto=format&n=N-faBULcr0WC2nPA&q=85&s=a09cfea1611b06412e0e735b60f84917" alt="Formulario Crear Aplicación en el portal Payphone Developer con Tipo Web, dominio chat-payments.jelou.ai y URL de respuesta configurados" width="1024" height="503" data-path="assets/images/integraciones/pagos/payphone-crear-aplicacion.png" />
    </Frame>
  </Step>

  <Step title="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:

    ```txt theme={null}
    Por favor asignar para integrar link de pago a través de app de terceros.
    ```

    <Frame caption="Modal de solicitud de compañía en Payphone Developer — ingresa el RUC de tu empresa y el motivo antes de guardar">
      <img src="https://mintcdn.com/jelouai/N-faBULcr0WC2nPA/assets/images/integraciones/pagos/payphone-solicitud-empresa.png?fit=max&auto=format&n=N-faBULcr0WC2nPA&q=85&s=5b0a3614c408b2bffb2e02fd1ffaea6b" alt="Modal Crear Solicitud en el portal Payphone Developer con campos de RUC y Motivos" width="1024" height="470" data-path="assets/images/integraciones/pagos/payphone-solicitud-empresa.png" />
    </Frame>

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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**.

    <Frame caption="Solicitud aprobada en Payphone Developer — haz clic en 'Ver todo el token' para copiar el Token de acceso completo">
      <img src="https://mintcdn.com/jelouai/N-faBULcr0WC2nPA/assets/images/integraciones/pagos/payphone-token.png?fit=max&auto=format&n=N-faBULcr0WC2nPA&q=85&s=3de359909529fd481186df60317a7364" alt="Tabla de solicitudes de compañía en Payphone Developer mostrando estado aprobado y el botón Ver todo el token" width="1024" height="259" data-path="assets/images/integraciones/pagos/payphone-token.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame caption="Listado de tiendas en Payphone Developer — copia el StoreId de la tienda asignada al usuario desarrollador">
      <img src="https://mintcdn.com/jelouai/N-faBULcr0WC2nPA/assets/images/integraciones/pagos/payphone-store-id.png?fit=max&auto=format&n=N-faBULcr0WC2nPA&q=85&s=906dfb5fae875695f8c1ab487af565a9" alt="Modal de listado de tiendas en Payphone Developer mostrando la columna StoreId" width="1024" height="329" data-path="assets/images/integraciones/pagos/payphone-store-id.png" />
    </Frame>

    <Check>
      Cuando ya tengas el **Token de acceso** y el **Store ID**, puedes continuar con la conexión en Brain Studio.
    </Check>
  </Step>
</Steps>

***

## Modo prueba y producción

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**

<Frame caption="Payphone Developer: selector Producción / Prueba">
  <img src="https://mintcdn.com/jelouai/dx7DsWHP4O-ZhgdO/assets/images/integraciones/pagos/payphone-cambio-entorno-desarrolladores.gif?s=5de0a75361884c2d3654b950ea63aa65" alt="Animación en Payphone Developer: cambio entre Producción y Prueba" width="1436" height="308" data-path="assets/images/integraciones/pagos/payphone-cambio-entorno-desarrolladores.gif" />
</Frame>

<Info>
  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**.
</Info>

<Warning>
  Antes de probar o pasar a producción, asegúrate de que el entorno seleccionado en Payphone coincide con el escenario que estás validando.
</Warning>

***

## Resolución de problemas

<AccordionGroup>
  <Accordion title="La solicitud de empresa sigue pendiente">
    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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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
  </Accordion>
</AccordionGroup>

***

## Buenas prácticas

<AccordionGroup>
  <Accordion title="Protege las credenciales">
    * No compartas el **Token de acceso** ni el **Store ID**
    * Si necesitas rotar el token, hazlo desde el portal de desarrolladores
    * Evita guardar estas credenciales en documentos públicos o repositorios
  </Accordion>
</AccordionGroup>

***

## Artículos relacionados

<CardGroup cols={2}>
  <Card title="Conectar en Brain Studio" href="/guides/integraciones/pagos/proveedores/payphone/conectar-en-brain-studio" icon="plug">
    Conecta Payphone en Marketplace usando el Token de acceso y el Store ID.
  </Card>

  <Card title="Uso y configuración" href="/guides/integraciones/pagos/proveedores/payphone/uso-y-configuracion" icon="gear">
    Configura el nodo de Payphone y maneja los estados del pago dentro del flujo.
  </Card>
</CardGroup>
