Upload support document

POST

https://api.gigstack.io/v2/payments/{id}/support-documents

Upload a supporting document (contract, proof of delivery, etc.) for a payment.

SAT 2026 Compliance: The Mexican tax authority (SAT) can request supporting documentation
to validate invoices and payments. This endpoint helps maintain compliance.

gigstack Connect: Upload documents for other teams' payments using the team parameter.

Supported File Types:

PDF files (.pdf)

Images (.png, .jpg, .jpeg, .webp)

File Size Limit: 10MB

Document Types:

contract: Service or product contracts

delivery_proof: Proof of delivery or service completion

payment_proof: Payment receipts or confirmations

communication: Emails, messages, or agreements

payment_confirmation: Payment processor confirmations

subscription_info: Subscription or recurring service details

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Path Params

Query Params

Body Params multipart/form-dataRequired

Responses

🟢201Created

application/json

Document uploaded successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/payments//support-documents?team' \
--header 'Authorization: <api-key>' \
--form 'file=@""' \
--form 'documentType=""' \
--form 'name="Service Contract"' \
--form 'description="Master services agreement for 2026"'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "id": "doc_abc123xyz",
        "document_type": "contract",
        "name": "Service Contract.pdf",
        "description": "Main service contract for consulting services",
        "file_url": "https://storage.googleapis.com/...",
        "file_name": "contract.pdf",
        "file_size": 245680,
        "mime_type": "application/pdf",
        "compliance_status": "pending_review",
        "compliance_notes": "string",
        "valid_from": 0,
        "valid_until": 0,
        "ai_extraction": {
            "extracted_at": 0,
            "extracted_by": "ai",
            "model": "gemini-3-flash",
            "confidence": 0.95,
            "extracted_data": {
                "property1": "string",
                "property2": "string"
            },
            "warnings": [
                "string"
            ]
        },
        "audits": [
            {
                "context_type": "invoice",
                "context_id": "string",
                "audited_at": 0,
                "result": "valid",
                "summary": "string",
                "details": {
                    "property1": "string",
                    "property2": "string"
                }
            }
        ],
        "created_at": 1677651234000,
        "created_by": "user_abc123",
        "updated_at": 1677651234000,
        "linked_entities": [
            {
                "entity_type": "invoice",
                "entity_id": "string",
                "linked_at": 0
            }
        ]
    },
    "message": "Support document uploaded successfully",
    "timestamp": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-02-19 18:12:08

Search payments

List support documents