---
title: "Expirar Customer Portal Session"
method: POST
path: "/v2/customer-portal-sessions/{session_id}/expire"
tags: ["Customer Portal"]
---

# Expirar Customer Portal Session

`POST /v2/customer-portal-sessions/{session_id}/expire`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/v2/customer-portal-sessions/{session_id}/expire`
- Auth: API key in header `x-api-key`

Expira una Customer Portal Session para invalidar su enlace antes de la fecha prevista.

Es idempotente: una sesión ya expirada se devuelve tal cual. Las Checkout Sessions abiertas que hayan nacido de esta sesión también quedan expiradas.

## Path parameters

- `session_id` string, required: Id de la Customer Portal Session, tal como se devolvió al crearla.

## Headers

- `x-account-key` string

## Response `200`

Successful Response

- CustomerPortalSessionResponse
  - `additional_metadata` object
  - `additional_query_parameters` object
  - `billing_data` object, required
  - `communication_channel` string
  - `expiration_datetime` string, date-time, required
  - `external_id` string
  - `flow_name` string, required
  - `id` string, required
  - `id_organization` integer, required
  - `journey_id` string
  - `payment_options_configuration` object
  - `redirection_configuration` object
  - `state` 'open' | 'expired', required: Estado de una sesión del portal de pago. Nace `open`, que es el único estado en que la sesión sirve para entrar al portal, y pasa a `expired` cuando se cumple su fecha de expiración o cuando se la expira a propósito. Es un cambio de una sola vía: una sesión expirada no vuelve a abrirse.
  - `template` string
  - `url` string, required

## Other responses

- `404`: No existe una Customer Portal Session con ese id bajo la organización.
- `422`: Validation Error

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/v2/customer-portal-sessions/:session_id/expire/post.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)