---
title: "Cobrar un método de pago guardado"
method: POST
path: "/one_time_payments"
tags: ["oneTimePayments"]
---

# Cobrar un método de pago guardado

`POST /one_time_payments`

Cobra directamente un método de pago guardado (token), sin necesidad de crear un checkout. El `payment_method_id` se obtiene del payload de un webhook o de un GET a un checkout pagado.

También puedes asociar el cobro a una suscripción enviando `subscription_id` (con `amount_in_cents` + `description`). Con `mode: now` se cobra de inmediato el método de pago de la suscripción; con `mode: next_cycle` se agrega un cobro pendiente que se cobra en el próximo cargo exitoso (admite créditos / montos negativos). La respuesta incluye un campo `object` (`one_time_payment` o `invoice_item`).

Si operas una plataforma, envía `X-ACCOUNT-ID` para cobrar bajo una cuenta conectada (modelo directo): el pago, los productos y la factura quedan bajo esa cuenta, y el método de pago o la suscripción deben pertenecerle. El `payment_method_id` de una cuenta conectada se obtiene del payload de sus webhooks (llegan al padre con `connected: true` y `account_id`).

## Headers

- `X-SECRET-KEY` string, required

## Request body

- union
  - OneTimePaymentsCreateOneTimePaymentRequest0
    - `payment_method_id` string, required — ID del método de pago guardado (obtenido del webhook o GET checkout pagado)
    - `items` OneTimePaymentsPostRequestBodyContentApplicationJsonSchemaOneOf0ItemsItems[], required — Productos a cobrar
      - `name` string — Nombre del producto
      - `currency` 'GTQ' | 'USD' — Moneda
      - `amount_in_cents` integer — Monto en centavos
      - `image_url` string — (Opcional) URL de la imagen
      - `quantity` integer — (Opcional) Cantidad, default 1
      - `product_id` string — (Alternativa) ID de un producto existente
  - OneTimePaymentsCreateOneTimePaymentRequest1
    - `subscription_id` string, required — ID de la suscripción a la que se asocia el cobro
    - `amount_in_cents` integer, required — Monto en centavos (moneda de la suscripción). Negativo = crédito, solo con mode `next_cycle`.
    - `description` string, required — Descripción visible para el cliente
    - `mode` 'now' | 'next_cycle' — `now` cobra de inmediato el método de pago guardado de la suscripción. `next_cycle` agrega un cobro pendiente (InvoiceItem) que se cobra en el próximo cargo exitoso y admite créditos.

## Response `200`

Pago cobrado (cobro directo o `mode: now`)

- OneTimePaymentsCreateOneTimePaymentResponse200
  - `object` string
  - `id` string — ID del pago
  - `status` string — Estado del pago

## Other responses

- `400` — Error en el pago
- `403` — One-time payments are disabled for this account
- `422` — Parámetros inválidos o método de pago inválido

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/f494a078482c/schema)