Offer closed event

This webhook event is triggered when a payment offer has expired — for example, because the shopper abandoned the session. For cards, offers expire after 12 hours by default. The event notifies your system that the offer is no longer open for completion, including the transaction references and the outcome, allowing you to reconcile the offer against your own records.

Webhook Example

{
    "checkoutReference": "8kf2m1nqp7xrbdtj9lw53cvhak0r4yzweqn82mhglox5tr9614",
    "payfacReference": "PPLKMXZWRA53QTF9",
    "merchantReference": "90817345672901",
    "amount": "250000",
    "currency": "ISK",
    "reason": "",
    "success": "true",
    "hmacSignature": "1g7a0Zyn/eVFC0eOoM0eoVxUX+lewmbDaEiocRdvqvo=",
    "additionalData": {
        "eventType": "OfferClosed"
    }
}

info

HMAC key: 5f1a9b3c8d2e6047a1b4c7d093e2f5681a3c9d7e4b206f81

Headers

In the Authorization header, we will set the matching Api key for your webhook.

Fields

You will always get these fields.

Field	Type	Description
checkoutReference	nullable string	Unique identifier for the payment that was done through a checkout.
payfacReference	string	Unique identifier for the payment generated by the payment service provider.
merchantReference	nullable string	The identifier for the payment provided by you, the merchant, allowing for correlation with the merchant’s system.
amount	string	The offer amount in the minor currency unit.
currency	string	The three-letter ISO currency code.
reason	nullable string	A field that provides additional context. Only populated when success is false; empty otherwise.
success	string	Indicates the outcome of the event (true/false). true means the event was executed successfully.
hmacSignature	string	A cryptographic signature generated using a secret, enabling verification of the message authenticity and ensuring it hasn’t been tampered with.
additionalData	object	An object for the additional details included in the event.

Additional Data Fields

Fields you will get depend on the event type of the webhook.

Field	Type	Description
eventType	string	A string representing the type of event that occurred.

HMAC Signature

The OfferClosed event uses the standard payment HMAC signing path: CheckoutReference, PayfacReference, MerchantReference, Amount, Currency, Reason, Success.

See HMAC Signature for the full signing reference and code samples.