Create payment complement (complemento de pago)

POST

https://api.gigstack.io/v2/invoices/payment

Stamp a CFDI type "P" payment complement (complemento de pago, Pagos 2.0) that
registers one or more payments against PPD (Pago en Parcialidades o Diferido) invoices.

Each entry in complements[].data is a payment. Each payment links one or more PPD
invoices through related_documents, supplying the amount paid, the installment number
and the previous balance so the SAT can compute the remaining balance.

Fixed by the SAT and therefore not required in the body: the comprobante currency
(XXX), the receptor UsoCFDI (CP01), and the line concept. The per-payment currency
lives in each payment's currency field. The series defaults to the team's payments
series (invoice_serie_payments).

gigstack Connect: Create for other teams using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Payment complement created successfully

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.gigstack.io/v2/invoices/payment?team=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "client": {
        "id": "client_1234567890"
    },
    "date": 1784915988000,
    "complements": [
        {
            "type": "payment",
            "data": [
                {
                    "payment_form": "03",
                    "date": "2026-07-24T12:00:00",
                    "currency": "MXN",
                    "exchange": 1,
                    "related_documents": [
                        {
                            "uuid": "A1B2C3D4-E5F6-7890-ABCD-1234567890AB",
                            "amount": 116,
                            "installment": 1,
                            "last_balance": 116,
                            "currency": "MXN",
                            "taxes": [
                                {
                                    "base": 100,
                                    "rate": "0.16",
                                    "factor": "Tasa",
                                    "type": "IVA",
                                    "withholding": false,
                                    "inclusive": false
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ],
    "return_files": false
}'

Response Example

200 - Example 1

{
    "message": "Payment complement created",
    "data": {
        "uuid": "invoice_1234567890",
        "client": {
            "id": "client_1234567890",
            "address": {
                "country": "MEX",
                "street": "Av. Insurgentes Sur",
                "zip": "03100",
                "city": "Ciudad de México",
                "state": "CDMX",
                "exterior": "123",
                "interior": "4B",
                "municipality": "Benito Juárez",
                "neighborhood": "Del Valle"
            },
            "name": "Juan Pérez García",
            "company": "Empresa SA de CV",
            "phone": "+52 55 1234 5678",
            "email": "juan.perez@ejemplo.com",
            "bcc": [
                "admin@empresa.com"
            ],
            "metadata": {
                "custom_field": "value"
            },
            "is_valid": true,
            "from": "api",
            "legal_name": "Juan Pérez García",
            "livemode": true,
            "owner": "user_1234567890",
            "tax_id": "PEGJ800101ABC",
            "use": "P01",
            "tax_system": "601",
            "team": "team_1234567890",
            "created_at": 1677651234,
            "efos": {
                "is_valid": true
            },
            "fiscal_validation": {
                "status": "valid",
                "message": "Fiscal info validation failed. El campo DomicilioFiscalReceptor del receptor, debe pertenecer al nombre asociado al RFC registrado en el campo Rfc del Receptor."
            },
            "sat_status": {
                "is_risky": true,
                "efos": {
                    "is_valid": false
                },
                "hits": [
                    {
                        "list": "art_69b_definitivos",
                        "label": "Definitivos 69-B",
                        "source": "art_69",
                        "is_risky": true,
                        "detail": {
                            "property1": "string",
                            "property2": "string"
                        }
                    }
                ],
                "checked_at": 1776887458784
            },
            "defaults": {
                "keep_full_legal_name": false,
                "issue_automatic_invoices": false,
                "issue_invoiceable_receipts": true
            }
        },
        "created_at": 1677651234,
        "currency": "MXN",
        "exchange_rate": 1,
        "total": 1160,
        "subtotal": 1000,
        "taxes": 160,
        "discount": 0,
        "withholding_taxes": 0,
        "series": "A",
        "folio_number": 123,
        "invoice_type": "I",
        "use": "P01",
        "payment_form": "03",
        "payment_method": "PUE",
        "status": "draft",
        "livemode": true,
        "owner": "user_1234567890",
        "from": "api",
        "items": [
            {
                "id": "item_1234567890",
                "description": "Professional consulting services",
                "product_key": "80141503",
                "quantity": 1,
                "unit_price": 1000,
                "unit_key": "E48",
                "unit_name": "Servicio",
                "sku": "CONS-001",
                "taxability": "01",
                "taxes": [
                    {
                        "base": 0,
                        "factor": "Tasa",
                        "inclusive": false,
                        "rate": 0.16,
                        "type": "IVA",
                        "withholding": false
                    }
                ]
            }
        ],
        "payments": [
            "payment_1234567890"
        ],
        "invoices": [],
        "stamp": {
            "sello": "ABC123...",
            "stamp_at": 1677651234
        },
        "cancellation": {
            "cancellation_status": "cancelled",
            "cancelled_at": 1677651234,
            "motive": "02",
            "code": "201"
        },
        "verification_url": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx",
        "exports": "01",
        "addenda": "",
        "invoice_pdf_notes": "Additional notes for PDF",
        "files": {
            "pdf": "JVBERi0xLjQKJeLjz9MKMSAwIG9ia...",
            "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4..."
        }
    }
}

Modified at 2026-07-24 19:44:45

Resend invoice email

Payments API Guide