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

# Liga de pago

> Estructura de las URLs del portal de pagos: identifica tu empresa por slug (/s/) o por companyCode (/c/).

El **portal de pagos** es la pantalla donde tu deudor ve lo que debe y paga. Se llega por una URL pública que combina el identificador de tu empresa con el identificador del usuario final.

<Note>
  Si creas deudas o ligas con la API, **no necesitas armar esta URL a mano**: el campo `paymentUrl` de la respuesta ya viene resuelto y apunta al portal (en el caso de las [deudas](/es/recursos/deudas) es además un deep link a esa deuda puntual). Esta página te sirve cuando quieres construir el enlace por tu cuenta, por ejemplo para llevar al usuario a su portal completo en lugar de a una deuda específica.
</Note>

## Los dos formatos

El portal acepta **dos formatos equivalentes**. Ambos resuelven al mismo lugar; cambia el prefijo y el identificador de empresa que uses.

<CodeGroup>
  ```text Por slug theme={null}
  https://app.tapipay.la/s/{slug}/portal/{identifierValue}
  ```

  ```text Por companyCode theme={null}
  https://app.tapipay.la/c/{companyCode}/portal/{identifierValue}
  ```
</CodeGroup>

<Tabs>
  <Tab title="Cuándo usar el slug">
    El `slug` es el nombre corto de tu empresa (por ejemplo, `acme-corp`). Corresponde al campo **Alias** en **Configuración → Organización** del dashboard.

    Conviene cuando manejas **una sola empresa** y quieres URLs legibles y con tu marca a la vista.
  </Tab>

  <Tab title="Cuándo usar el companyCode">
    El `companyCode` es el código de empresa configurado para tu organización en TapiPay (por ejemplo, `MX-S-12345`).

    Conviene cuando manejas **muchas empresas o sub-billers**: armas el enlace con el `companyCode` de cada una, sin necesidad de conocer ni administrar su `slug`.

    <Note>
      El valor exacto es el que tenga configurado tu organización, y el formato varía entre integraciones. Si no estás seguro de cuál es el tuyo, confírmalo con tu contacto de TapiPay antes de armar enlaces en masa.
    </Note>
  </Tab>
</Tabs>

## Componentes de la URL

| Parte                    | Ejemplo                                                   | Tipo     | Descripción                                                                                 |
| ------------------------ | --------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------- |
| Dominio y prefijo        | `https://app.tapipay.la/s/` o `https://app.tapipay.la/c/` | Fijo     | El prefijo define cómo se identifica la empresa: `/s/` por `slug`, `/c/` por `companyCode`. |
| Identificador de empresa | `acme-corp` o `MX-S-12345`                                | Variable | Tu empresa en TapiPay. Con `/s/` va el `slug`; con `/c/` va el `companyCode`.               |
| Ruta del portal          | `/portal/`                                                | Fijo     | Segmento que dirige al módulo de portal de pagos.                                           |
| `identifierValue`        | `CLI-00042`                                               | Variable | El identificador del usuario final, el mismo que envías al crear la deuda.                  |

## Reglas

<Warning>
  **No mezcles los identificadores con los prefijos.** Detrás de `/s/` va siempre el `slug` y detrás de `/c/` va siempre el `companyCode`. Un `companyCode` detrás de `/s/` no resuelve.
</Warning>

* **Mayúsculas:** el `slug` va en minúsculas. El `companyCode` se usa **tal cual** te fue asignado. El `identifierValue` puede ser sensible a mayúsculas según cómo se generó.
* **Separadores:** usa siempre la barra (`/`) entre componentes.
* **Dominio:** usa `app.tapipay.la`. Los dominios `www.tapipay.la` y `tapipay.la` redirigen ahí, así que funcionan, pero agregan un salto de redirección innecesario (y conviene evitarlo si vas a [embeber el portal](/es/portal-de-pagos/embeber-portal) en un iframe).

## Ejemplo

Las dos filas apuntan al mismo portal para el mismo usuario final:

| Identificación              | `identifierValue` | Enlace                                                 |
| --------------------------- | ----------------- | ------------------------------------------------------ |
| `slug`: `acme-corp`         | `CLI-00042`       | `https://app.tapipay.la/s/acme-corp/portal/CLI-00042`  |
| `companyCode`: `MX-S-12345` | `CLI-00042`       | `https://app.tapipay.la/c/MX-S-12345/portal/CLI-00042` |

## A dónde llega el usuario

La URL base del portal lleva a la **lista de deudas** del usuario. Desde ahí puede elegir qué pagar y con qué medio.

| Ruta                                | Pantalla                                                      |
| ----------------------------------- | ------------------------------------------------------------- |
| `/portal/{identifierValue}`         | Deudas pendientes (es la pantalla inicial).                   |
| `/portal/{identifierValue}/autopay` | Gestión de domiciliación: ver, adherir y desadherir un medio. |

<Tip>
  Si en lugar del portal completo quieres mostrar solo los medios de pago o solo la gestión de domiciliación **dentro de tu propio sitio**, usa el SDK: [Medios de pago](/es/portal-de-pagos/sdk-medios-de-pago) o [Gestión de adhesiones](/es/portal-de-pagos/sdk-adhesiones).
</Tip>