TRtrytoku
Facturación

Crear complemento de pago PPD desde movimiento de wallet

Changed on

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.

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

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

id_accountstring required

Identificador público de la Account que emite el complemento.

issue_datestring date-time

Fecha de emisión en formato ISO 8601. Si se omite, se usa la del momento del timbrado.

payment_intent_idsstring[] 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.

Example request

{
  "id_account": "acc_Nkj5FQ4blAzg-ieIKeRpULgj4hjTf-UJ",
  "issue_date": "2026-08-12T10:30:00",
  "payment_intent_ids": [
    "pi_2Kd8Nm4Qr7Tv1Wy3Xz5Ab6Cd8Ef0Gh"
  ]
}

Response

Successful Response

billing_addressstring
billing_emailstring
checkout_session_idstring
discountnumber required
fiscal_billing_idstring required
foliostring required
id_accountstring required
id_billing_documentstring required
id_customerstring
id_invoicestring
id_transactionstring
issue_datestring date-time required
pdf_urlstring required
provider_external_idstring required
public_pdf_urlstring
public_xml_urlstring
related_fiscal_billing_idstring
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_totalnumber required
tax_idstring required
tax_regimestring required
tax_zip_codestring required
totalnumber 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_urlstring required

Changes