Pay In - SPEI - PayPaga

Callback Request Parameters

Parameter	Description	Details
`transaction_id`	Unique PayPaga-assigned transaction identifier	—
`status`	Current transaction status	Enum values: - `Approved` — Payment successfully processed (final success state) - `Declined` — Payment declined during processing (final failure state) - `Error` — Unexpected processing error (final failure state) - `Canceled` — Transaction canceled by the provider (final failure state)
`transaction_type`	Transaction type	Enum values: - `Payin` — Pay-in transaction - `Payout` — Pay-out transaction
`merchant_transaction_reference`	Merchant-defined transaction identifier used for correlation	- Max length: `45` - Pattern: `^[A-Za-z0-9-_]+`
`transaction_input`	Original data provided by the merchant or end customer to PayPaga when initiating the payment Examples	—
`processing_output`	Data verified during payment processing Examples	—
`transaction_amount`	Amount originally requested	For unsolicited pay-ins, this value is system-defined and matches the `paid_amount` field
`paid_amount`	Amount effectively received	Funds credited to the assigned CLABE account
`unsolicited_payment`	Indicates whether the pay-in was automatically generated	`true` if the transfer was received without a prior API-created transaction

Unsolicited payments can be matched to prior solicited payments using the data in the processing_output field, account number used to make the payment (account_number) and the RFC_CURP (document_number).

Callback Examples

Unsolicited Payment

{
    "transaction_id": "20250516-1036-4c6e-9340-1d7769e556ae",
    "status": "Approved",
    "merchant_id": "50249f9c-2e0b-4d6a-bd44-0a9207b508dc",
    "transaction_type": "payin",
    "merchant_transaction_reference": "XXXXXXXX-XXXX-XXX",
    "country_code": "MX",
    "currency": "MXN",
    "payment_method_code": "BNKTR",
    "transaction_input": {
        "document_number": "20123456786",
    },
    "processing_output": {
        "document_number": "20123456786",
        "document_type": "RFC_CURP",
        "first_name": "Jon",
        "last_name": "Snow",
        "account_number": "012180001234567895",
        "bank_code": "012"
    },
    "transaction_amount": 1000,
    "paid_amount": 1000,
    "unsolicited_payment": true
}

Callback Response

Status code: 200

Body: empty

Any other status code is treated as a failed webhook request.

Retry Policy

PayPaga retries the notification using exponential backoff. The formula used is attempt ^ 4 + rand(±10%).

After all attempts have failed, a V1 Notification Failed event will be triggered to the configured channels with the payload.

To retrieve more details about the notified transaction, use the relevant Transaction Query API for the transaction type.

Pay In - SPEI

Callback Examples#

Callback Examples