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 Forms | Formas de pago

Overview#

The Payment Forms catalog defines the standardized codes used to identify different payment methods in the system. These codes follow Mexican tax regulations (SAT) and are essential for proper invoice classification and tax compliance.

What We See#

This catalog contains 21 different payment form codes, ranging from traditional methods like cash and checks to modern electronic payment systems. Each code represents a specific way customers can pay for goods or services, with clear distinctions between different types of electronic payments, credit instruments, and special payment arrangements.

How to Use It#

When creating invoices or processing payments, select the appropriate payment form code that matches the actual payment method used by the customer. This ensures proper tax reporting and compliance with Mexican fiscal regulations.

Usage Guidelines#

Always use the exact code: Payment form codes must match exactly as specified
Choose the most specific option: If multiple codes could apply, use the most specific one
Document special cases: For codes like "99" (Por definir), ensure proper documentation
Validate before processing: Verify the payment form code matches the actual payment method

Payment Forms Table#

CodeDescription (English)Descripción (Español)Usage Notes
01CashEfectivoPhysical currency payments
02Nominative checkCheque nominativoChecks made out to a specific payee
03Electronic funds transferTransferencia electrónica de fondosBank-to-bank electronic transfers
04Credit cardTarjeta de créditoCredit card payments
05Electronic walletMonedero electrónicoDigital wallet services
06Electronic moneyDinero electrónicoDigital currency systems
08Food vouchersVales de despensaEmployee benefit vouchers
12Payment in kindDación en pagoPayment with goods instead of money
13Subrogation paymentPago por subrogaciónThird-party payment on behalf of debtor
14Consignment paymentPago por consignaciónCourt-ordered deposit payment
15Debt forgivenessCondonaciónVoluntary debt cancellation
17CompensationCompensaciónOffsetting mutual debts
23NovationNovaciónReplacing old debt with new obligation
24ConfusionConfusiónCreditor and debtor become same person
25Debt remissionRemisión de deudaFormal debt release
26Statute of limitationsPrescripción o caducidadDebt expired by time limit
27Creditor satisfactionA satisfacción del acreedorPayment accepted by creditor
28Debit cardTarjeta de débitoDebit card payments
29Service cardTarjeta de serviciosPrepaid service cards
30Advance applicationAplicación de anticiposUsing previously paid advances
31Payment intermediaryIntermediario pagosThird-party payment processors
99To be definedPor definirPlaceholder for undefined methods

Implementation Examples#

API Request Example#

{
  "invoice": {
    "payment_form": "04",
    "amount": 1500.00,
    "currency": "MXN"
  }
}

Validation Logic#

Common Use Cases#

Electronic Payments#

Code 03: Bank transfers, wire transfers
Code 04: Visa, MasterCard, American Express
Code 05: PayPal, digital wallets
Code 28: Debit card transactions

Traditional Payments#

Code 01: Cash transactions
Code 02: Business checks

Special Arrangements#

Code 12: Barter or trade agreements
Code 15: Debt forgiveness agreements
Code 30: Using customer deposits or advances

Important Notes#

1.
Tax Compliance: Always ensure the selected payment form aligns with actual payment method for proper SAT reporting
2.
Audit Trail: Maintain documentation linking payment form codes to actual transaction records
3.
Electronic vs Physical: Distinguish clearly between electronic payment methods (codes 03, 05, 06) and physical cards (codes 04, 28)
4.
Legal Implications: Codes 12-17 and 23-27 represent legal payment arrangements that may require additional documentation

Related Documentation#

Payment Methods Catalog - For payment method classifications
Tax Regimes Catalog - For tax-related classifications
Invoice Globals - For general invoice configuration
Modified at 2025-08-21 00:06:01
Previous
Tax Regimes Catalog (Régimen Fiscal)
Next
CFDI Usage Catalog (Uso CFDI)
Built with