---
title: "Crear complemento de pago PPD desde movimiento de wallet"
method: POST
path: "/billing-documents/ppd-complement/wallet-movement"
tags: ["Facturación"]
---

# Crear complemento de pago PPD desde movimiento de wallet

`POST /billing-documents/ppd-complement/wallet-movement`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/billing-documents/ppd-complement/wallet-movement`
- Auth: API key in header `x-api-key`

Emite el complemento de pago de un billing document PPD a partir de un movimiento de wallet.

Genera el CFDI de complemento de pago para los payment intents del movimiento de wallet indicado y registra el evento de creación. Devuelve los billing documents emitidos.

## Headers

- `x-account-key` string

## Request body

- CreatePPDComplementFromWalletMovementRequest: Cuerpo para emitir complementos de pago a partir de movimientos de wallet.
  - `id_account` string, required: Identificador público de la Account que emite el complemento.
  - `issue_date` string, date-time: Fecha de emisión en formato ISO 8601. Si se omite, se usa la del momento del timbrado.
  - `payment_intent_ids` string[], required: Identificadores públicos de los Payment Intents pagados desde el wallet que el complemento acredita.
  - `payment_method_type` '01' | '03' | '04' | '28' | '99', required: Forma de pago con la que se timbra el comprobante, en los códigos del catálogo `c_FormaPago` del SAT. Toku la deduce del medio con el que se cobró: `01` efectivo, `03` transferencia electrónica de fondos, `04` tarjeta de crédito y `28` tarjeta de débito, donde el BIN de la tarjeta decide entre estas dos últimas. `99` es "por definir" y no describe un medio de pago: lo llevan los comprobantes PPD, emitidos antes de que el pago ocurra, y es también el valor de respaldo cuando la forma de pago no se puede determinar.

## Response `201`

Successful Response

- BillingDocumentResponse[]
  - `billing_address` string
  - `billing_email` string
  - `checkout_session_id` string
  - `discount` number, required
  - `fiscal_billing_id` string, required
  - `folio` string, required
  - `id_account` string, required
  - `id_billing_document` string, required
  - `id_customer` string
  - `id_invoice` string
  - `id_transaction` string
  - `issue_date` string, date-time, required
  - `pdf_url` string, required
  - `provider_external_id` string, required
  - `public_pdf_url` string
  - `public_xml_url` string
  - `related_fiscal_billing_id` string
  - `status` 'ISSUED' | 'FAILED' | 'CANCELLED' | 'PENDING_CANCELLATION': Estado de un comprobante fiscal mexicano ante el SAT. Nace `ISSUED`, que es el documento ya timbrado y vigente. Pedir su cancelación lo deja en `PENDING_CANCELLATION` mientras el receptor la acepta, y el documento sigue vigente durante esa espera: pasa a `CANCELLED` si la acepta, y vuelve a `ISSUED` si la ventana de aceptación vence sin respuesta. `FAILED` está declarado pero ningún flujo lo emite: el comprobante se registra solo después de timbrarse, así que un timbrado fallido no deja documento.
  - `sub_total` number, required
  - `tax_id` string, required
  - `tax_regime` string, required
  - `tax_zip_code` string, required
  - `total` number, required
  - `type` 'INVOICE' | 'CREDIT_NOTE' | 'COMPLEMENT': Clase de comprobante fiscal mexicano (CFDI) que se emitió: `INVOICE` es la factura de ingreso que documenta la venta, `COMPLEMENT` el complemento de pago que acusa el pago de una factura PPD ya emitida, y `CREDIT_NOTE` la nota de crédito que rebaja o revierte un comprobante anterior, relacionada al CFDI original.
  - `xml_url` 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/billing-documents/ppd-complement/wallet-movement/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)