---
title: "Crear Payment Flow"
method: POST
path: "/integration-entrypoint-mx/v1/{organization}/payment-flows"
tags: ["Payment Flows"]
---

# Crear Payment Flow

`POST /integration-entrypoint-mx/v1/{organization}/payment-flows`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/integration-entrypoint-mx/v1/{organization}/payment-flows`
- Auth: API key in header `x-api-key`

Registra el inicio de un payment flow de integración y devuelve su journey_id. Es el punto de entrada que invoca Workato al comenzar un flujo de pago: valida la organización de la ruta (responde HTTP 404 si es desconocida), acuña el journey_id del flujo, resuelve el tipo de flujo (header x-flow o su equivalente en el body) y el identificador externo según la organización, y registra el evento de inicio. El body es de formato libre y se procesa de forma tolerante (un body vacío o no-JSON se trata como vacío). No reenvía la solicitud a ningún otro servicio: responde con el journey_id acuñado para que el llamador lo propague en los pasos siguientes.

**Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Path parameters

- `organization` string, required: Identificador de la organización en la ruta (por ejemplo el slug o código del cliente de integración).

## Headers

- `x-account-key` string

## Response `200`

Successful Response

- PaymentFlowAccepted
  - `external_id` string, nullable
  - `flow` string, nullable
  - `journey_id` string, nullable
  - `organization` string, required

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/integration-entrypoint-mx/v1/:organization/payment-flows/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)