---
title: "Customer Portal Session"
method: POST
path: "/v2/customer-portal-sessions"
---

# Customer Portal Session

`POST /v2/customer-portal-sessions`

Crea una sesión asociada a un customer en el portal de pagos, y devuelve su url.

## Headers

- `x-api-key` string, required

## Request body

- object
  - `billing_data` object, required — Datos de a quién pertenece la sesión.
    - `id_customer` string, required — ID público del customer. Debe pertenecer a la organización.
    - `id_account` string — ID público de la cuenta. Si se omite, usa la cuenta principal de la organización.
  - `expiration_datetime` string, required — Fecha de expiración. Mínimo 30 min en el futuro. Se normaliza a UTC.
  - `flow_name` string — Flow a utilizar para la sesión. Default "0".
  - `external_id` string — Clave de referencia/idempotencia. Única para sesiones de la organización.
  - `communication_channel` 'mail' | 'sms' | 'wsp' — Canal por el que se envía el link al cliente.
  - `template` string — ID público del template de mensajería. Si se envía, ese utiliza este template para enviar el mensaje al cliente.
  - `additional_metadata` string — Metadata libre, se persiste.

## Response `201`

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/trytoku/apis/toku-api.md) · [All operations](https://skmtc.net/trytoku/apis/toku-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trytoku/toku-api/versions/30699b13e0d0/schema)