Webhook Pago Exitoso

Informe en tiempo real de cada pago realizado de sus ordenes desde su Perfil de Cliente.

Flujo Hook Informativo

Flujo Hook

1. Merchant: Impreso en su orden de pago, o por medio de su CRM le brinda al cliente su Link de pago.

2. El cliente realiza el pago de una o más órdenes de pago.

3. En caso exitoso Pagoralia informará el pago de cada orden de pago, individualmente por medio de su Hook para el impacto de dicho pago en el software de gestión del Merchant.

Informes del Hook

Los informes del hook se realizarán individualizados por orden de pago creada en Pagoralia. Ej: si el cliente paga 2 órdenes de pago existentes en su perfil, el hook realizará dos informes separados, uno por cada orden de pago.

El webhook será una url que el Merchant deberá enviar a Pagoralia para que sea configurado y utilizado.

Respuesta

HTTP Status Code	Descripción
102	Hook en proceso
201	Ejecutado satisfactoriamente
200	Ejecutado
203	Expired
404	No encontrado
401	Token not provided | Invalid token
428	Conciliación manual notificada por mail
500	Error en el servidor del Merchant

BODY Respuesta

Nombre del campo	Formato	Tamaño	Descripción
id	Alfanumérico		Código de referencia de la factura.
number	Número		ID de depósito
date_operation	Fecha		Fecha de la operación
transaction_id	Número		Id de transacción
order_id	Número		Id de la orden generada
created_at	Fecha		Fecha de creación
updated_at	Fecha		Fecha de actualización
status	Texto		Estado del pago
fee_on_payer	booleano		True: Comision pagada por cliente. False: Comision absorvida por merchant

Ejemplo JSON Respuesta Hook

{
    "id": "HASH-1234567",
    "date_operation": "2024-01-05T19:09:57.000000Z",
    "transaction_id": 3483,
    "order_id": 3570,
    "number": "895868981",
    "created_at": "2024-01-05T19:09:57.000000Z",
    "updated_at": "2024-01-05T20:27:01.000000Z",
    "order": {
        "id": 3570,
        "payer_id": "136",
        "status": "paid",
        "reference": "HASH-1234567",
        "total": 299,
        "currency": "MXN",
        "user_agent": "Mozilla/5.0 (Linux; Android 13; SAMSUNG SM-A145M) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/23.0 Chrome/115.0.0.0 Mobile Safari/537.36",
        "description": "Factura #10638",
        "language": "es",
        "payer": {
            "id": "136",
            "external_id": "ho_w0bI5JN",
            "document_number": null,
            "document_type": null,
            "first_name": "Jhon",
            "last_name": "Contoso",
            "email": "[email protected]",
            "last_address": [
                {
                    "id": 753,
                    "line_one": "39 X 36 Y 36C INT. 102",
                    "line_two": null,
                    "line_three": null,
                    "city": "UMAN",
                    "state": "cdm",
                    "country_id": "MX",
                    "payer_id": "136",
                    "meta": null,
                    "created_at": "2023-10-06T01:07:55.000000Z",
                    "updated_at": "2023-10-06T01:07:55.000000Z"
                }
            ]
        }
    },
    "transaction": {
        "id": 3483,
        "number": "895868981",
        "expiration_date": "2024-01-05T17:19:26.000000Z",
        "is_success": true,
        "details": {
            "type": "CREDIT_CARD",
            "amount": 309.41,
            "currency": "MXN",
            "created_at": "2024-01-05 17:09:26",
            "payment_method": "VI",
            "expiration_date": "2024-01-05 17:19:26",
            "payment_method_name": "Visa"
        },
        "card_detail": "{\"card_holder\": \"JHON\", \"masked_card\": \"************7308\"}"
    },
    "status": "COMPLETED",
    "isProduction": true,
    "merchant": "{merchant-abrev}",
    "fee_on_payer": true
}

Para merchants que poseen comisiones dinámicas, usar "order.total"