---
title: "Apply Payment Endpoint"
method: POST
path: "/puntored/v1/applyPayment"
tags: ["puntored"]
---

# Apply Payment Endpoint

`POST /puntored/v1/applyPayment`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/puntored/v1/applyPayment`
- Auth: API key in header `x-api-key`

Log the raw body, cast it, accept the payment idempotently, and store the raw event.

## Request body

- object

## Response `200`

Successful Response

- ApplyPaymentResponse: POST /v1/applyPayment response. Aliases are the frozen Puntored contract names.
  - `autorizacion` string, required
  - `estatusTransaccion` 'APROBADA' | 'CANCELADO', required: Desenlace que Toku le devuelve a Puntored en `estatusTransaccion`. `APROBADA` es que el pago quedó aplicado a la referencia consultada; `CANCELADO`, que la transacción se anuló. No hay valor intermedio: la respuesta se emite una vez resuelto el pago, nunca mientras se procesa.
  - `externalReference` 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/puntored/v1/applyPayment/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)