---
title: "Notificar pago a PlanOk"
method: POST
path: "/planok/notify-payment"
tags: ["PlanOk"]
---

# Notificar pago a PlanOk

`POST /planok/notify-payment`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/planok/notify-payment`
- Auth: API key in header `x-api-key`

Informa a PlanOk que una deuda cobrada en Toku quedó pagada.

Se usa para cerrar el ciclo de conciliación: por cada pago recibido se actualiza el pago en PlanOk y se marca la cuota como contabilizada, y según la configuración de la organización también como conciliada.

La respuesta de éxito no devuelve datos. Cuando falta una precondición para notificar —la organización no tiene configurada la integración, no hay credenciales de PlanOk o no existen datos de abono para la cuenta— la respuesta usa el código `299` con el motivo en el cuerpo, para no provocar reintentos de la cola de tareas que invoca este endpoint. Un error de comunicación con PlanOk responde `500` y sí debe reintentarse.

## Request body

- PlanOkNotificationPayload
  - `id_account` integer, required: Account id
  - `payment_intent_resume` PaymentIntentResume[], required: Payments to register paid on planok
    - `amount` number, required
    - `id` integer, required
    - `id_invoice` integer, required: Invoice id
    - `id_transaction` integer, required
    - `toku_product` string, required: payiment intent transaction date
    - `transaction_date` string, required: payiment intent transaction date

## Response `200`

Successful Response

- AcknowledgedResponse: Confirmación de que la operación se completó, sin datos adicionales. El cuerpo de la respuesta es un objeto vacío: la operación no devuelve información propia y lo relevante es el código de estado.

## 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/planok/notify-payment/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)