Skip to content

Notify Payment Result (Webhook)

An endpoint that will be triggered to send the payment result of the transaction to the integrator-defined notification URL upon boarding.

When integrator register a webhook, integrator will receive notifications on the registered URL. This notification is standard responses wrapped in the “payload”.

To be notified with the payment result, integrator will need to prepare the endpoint that accepts the following requirements.

Request Description

Notify POST HEADER!

{

            "iss": "Billeroo",
            "sub": "Billeroo Notification Authentication",
            "aud": "Billeroo Notification",
            "iat": 1773137668,
            "jti": "c9a4756c-e7d6-4195-a5e5-76635848d8bd",
        "transaction": {
            "billerCode": "SSS",
            "billerName": "SociaL Security System",
            "billingAmount": "750.00",
            "merchantReference": "{TESTMERCHREF324256346}",
            "processorReference": "{TESTPROCREF3500010122}",
            "transactionReference": "{TESTTRANSREF00000101}"
        },
        "payment": {
            "totalAmountPaid": "773.00",
            "convenienceFee": "23.00",
            "currency": "PHP",
            "timestamp": "2026-03-10 10:14:24 +00:00",
            "paymentOption": "VISA",
            "payorName": "JUAN DELA CRUZ",
            "email": "juandelacruz@gmail.com"
        },
    "result": {
        "statusCode": "ER.00.00",
        "message": "Payment Posted",
        "timestamp": "2026-03-10 10:14:24 +00:00"

    }
}


Custom parameters passed in transaction processing will be returned in the custom_parameters object if any.