gigstack API
  1. Catalogs
gigstack API
  • Welcome to gigstack API
  • gigstack Connect API Guide
  • Migrar de API v1 a v2 de gigstack
  • Clients
    • Clients API Guide
    • List clients
      GET
    • Get client
      GET
    • Update client
      PUT
    • Create client
      POST
    • Validate client fiscal information
      POST
    • Get client customer portal access token
      POST
    • Stamp pending receipts
      POST
    • Delete client
      DELETE
  • Services
    • Services API Guide
    • List services
      GET
    • Get service
      GET
    • Update service
      PUT
    • Create service
      POST
    • Delete service
      DELETE
  • Invoices
    • Invoices API Guide
    • Income
      • List income invoices
      • Get income invoice
      • Create income invoice
    • Egress
      • List egress invoices
      • Get egress invoice
      • Create egress invoice
    • Get invoice files
      GET
    • Cancel invoice
      DELETE
  • Payments
    • Payments API Guide
    • List payments
    • Get payment
    • Request payment
    • Register payment
    • Mark payment as paid
    • Refund payment
    • Cancel payment
  • Receipts
    • Receipts API Guide
    • List receipts
    • Get receipt
    • Create receipt
    • Stamp receipt
    • Cancel receipt
  • Teams
    • Teams API Guide
    • List teams
    • Get team
    • Get team integrations
    • Get team series
    • Get team onboarding URL
    • Update team
    • Update team series
    • Update team settings
    • Create team
    • Add team member
    • Remove team member
    • Create team series
  • Users
    • Users API Guide
    • List users
    • Get user
    • Update user
    • Create user
    • Reset user password
  • Catalogs
    • Tax Regimes Catalog (Régimen Fiscal)
    • Payment Forms | Formas de pago
    • CFDI Usage Catalog (Uso CFDI)
    • Payment Methods Catalog (Método de Pago)
    • Months and Bimesters Catalog (Meses y Bimestres)
    • Invoice Relationships Catalog (Relación entre Facturas)
  1. Catalogs

Payment Methods Catalog (Método de Pago)

Overview#

The Payment Methods catalog defines the two fundamental ways invoices can be structured regarding payment timing in the Mexican CFDI system. This classification determines whether an invoice requires immediate payment or allows for deferred/partial payments, which has significant implications for tax reporting and document management.

What We See#

This catalog contains only 2 payment method codes, but these represent fundamentally different business models:
PUE: Immediate payment transactions (cash sales)
PPD: Credit transactions requiring payment tracking and additional documentation
Unlike payment forms (which specify HOW payment is made), payment methods specify WHEN payment occurs relative to the invoice issuance.

How to Use It#

Select the payment method that matches your business transaction model. This decision affects the entire invoice lifecycle, from initial issuance to final payment tracking and tax compliance requirements.

Usage Guidelines#

Choose based on payment timing: Use PUE for immediate payments, PPD for credit arrangements
Consider document requirements: PPD requires additional payment complement documents
Plan for compliance: PPD invoices require ongoing payment tracking until fully paid
Validate business model: Ensure your payment method aligns with actual business practices

Payment Methods Table#

CodeDescription (English)Descripción (Español)Payment TimingAdditional Requirements
PUESingle payment (cash)Pago en una sola exhibición (de contado)Immediate/concurrent with invoiceNone - payment is complete
PPDInstallment or deferred paymentPago en parcialidades o diferidoFuture/partial payments allowedPayment complement documents required

PUE vs PPD: Key Differences#

PUE (Pago en Una Exhibición)#

Payment Timing: Payment is made immediately when the invoice is issued
Use Cases: Cash sales, immediate bank transfers, point-of-sale transactions
Documentation: Single invoice document suffices
Tax Implications: Full tax liability established at invoice date
Business Impact: Simplified accounting, immediate cash flow

PPD (Pago en Parcialidades o Diferido)#

Payment Timing: Payment occurs after invoice issuance, may be partial or in installments
Use Cases: Credit sales, layaway plans, subscription services, B2B credit terms
Documentation: Requires payment complement (Complemento de Pago) for each payment received
Tax Implications: Tax liability established at invoice date, but payment tracking required
Business Impact: Extended payment terms, accounts receivable management needed

Implementation Examples#

API Request Examples#

PUE Invoice#

{
  "invoice": {
    "payment_method": "PUE",
    "payment_form": "04",
    "total": 1160.00,
    "status": "paid"
  }
}

PPD Invoice#

{
  "invoice": {
    "payment_method": "PPD",
    "payment_form": "99",
    "total": 5800.00,
    "status": "pending_payment",
    "due_date": "2024-02-15"
  }
}

Validation Logic#

Payment Complement for PPD#

Business Scenarios#

When to Use PUE#

Retail Sales: Customer pays at point of sale
Restaurant Transactions: Payment upon service completion
Online Purchases: Payment processed during checkout
Professional Services: Payment upon service delivery
Small Transactions: Where credit terms are unnecessary

When to Use PPD#

B2B Sales: 30, 60, or 90-day payment terms
Large Purchases: Customer needs time to arrange financing
Subscription Services: Monthly/annual billing cycles
Construction Projects: Progress-based payments
Layaway Programs: Customer pays in installments

Payment Complement Requirements (PPD Only)#

When using PPD, you must issue payment complement documents for each payment received:

Required Information#

Original invoice UUID reference
Payment date and amount
Actual payment form used (01, 02, 03, etc.)
Exchange rate (if applicable)
Bank account information (if applicable)

Compliance Timeline#

Payment complements must be issued within specific timeframes
All payments must be tracked until invoice is fully paid
Proper accounting entries required for each payment

Common Implementation Patterns#

E-commerce Platform#

B2B Invoice System#

Important Considerations#

Tax Implications#

1.
PUE: Tax obligation and payment occur simultaneously
2.
PPD: Tax obligation established at invoice date, regardless of payment status
3.
Deductibility: Expenses may be deductible at different times depending on method

Cash Flow Management#

1.
PUE: Immediate cash collection, predictable cash flow
2.
PPD: Extended collection periods, requires working capital management
3.
Risk Assessment: PPD carries credit risk that must be managed

System Requirements#

1.
PUE: Standard invoicing system sufficient
2.
PPD: Requires payment tracking, complement generation, and accounts receivable management
3.
Integration: Payment processing systems must align with chosen method

Error Prevention#

Common Mistakes#

Using PUE for credit sales (creates compliance issues)
Using PPD for immediate transactions (unnecessary complexity)
Forgetting to issue payment complements for PPD
Mixing payment methods inappropriately

Best Practices#

Clearly define payment terms in customer agreements
Implement automated payment complement generation for PPD
Train staff on the implications of each payment method
Regular reconciliation of PPD invoices and payments

Related Documentation#

Payment Forms Catalog - For specific payment method codes
CFDI Usage Catalog - For expense classification
Tax Regimes Catalog - For tax regime compatibility
Invoice Globals - For general invoice configuration
Modified at 2025-08-21 00:36:26
Previous
CFDI Usage Catalog (Uso CFDI)
Next
Months and Bimesters Catalog (Meses y Bimestres)
Built with