---
title: "Cobrar Invoices con tarjeta tokenizada"
method: POST
path: "/pay-invoices/tokenized-cards"
tags: ["Payment Intents"]
---

# Cobrar Invoices con tarjeta tokenizada

`POST /pay-invoices/tokenized-cards`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/pay-invoices/tokenized-cards`
- Auth: API key in header `x-api-key`

Dispara el cobro manual de un conjunto de Invoices con la tarjeta guardada del Customer.

Se usa para adelantar el cobro de Invoices en vez de esperar la corrida automática. Cada Invoice se valida por separado: la respuesta lista las que quedaron agendadas y agrupa las descartadas por el motivo que las dejó fuera.

El cobro es asíncrono: la respuesta no informa si el pago resultó exitoso.

## Headers

- `x-account-key` string

## Request body

- PayTokenizedCardsInvoicesPayload: Subclass of BaseModel that handles encryption/decryption of ids to translate external ids to internal ids and vice versa. _models defines which db entity corresponds to each key in the way "key": "db model"
  - `invoices_ids` string[], required

## Response `200`

Successful Response

- TokenizedCardsInvoicesResponse: Resultado de la validación de las Invoices enviadas a cobro con tarjeta guardada.
  - `failed` object, required: Invoices descartadas, agrupadas por el motivo que las dejó fuera: la clave es el tipo de error de validación y el valor, las Invoices que lo presentaron.
  - `successful` string[], required: Invoices que pasaron todas las validaciones y cuyo cobro quedó agendado.

## 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/pay-invoices/tokenized-cards/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)
