Adjustment event

This webhook event is triggered when a payment amount has been adjusted after the initial transaction. The event includes the adjusted amount and references to the original payment for proper transaction reconciliation.

Webhook Example

{
    "checkoutReference": "kxhbi28jdlo55lbk1u4eskmprbdd9mkh6cj5mpotlduclf13fi",
    "payfacReference": "4WHT92XEIL2EXMHZ",
    "merchantReference": "23770963420369",
    "amount": "48900",
    "currency": "ISK",
    "reason": "",
    "success": "true",
    "hmacSignature": "urlLKKMuoPZK4w6IAoGMiKKbKsG2CYyUN/2CiXeGumA=",
    "additionalData": {
        "eventType": "Adjustment",
        "authCode": "123457",
        "cardNumber": "411111******1111",
        "cardUsage": "Debit",
        "originalPayfacReference": "OOJWITWVQV42PSE8",
        "paymentMethod": "VI",
    }
}

info

HMAC key: 388845ce3c794d9bb8e7082a57a05395c2830f556a29f8e4

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	Reference generated for this adjustment request. This is not the checkoutReference of the original checkout session — use originalPayfacReference to find the payment. See Reference fields.
payfacReference	string	Unique identifier of this adjustment. It matches the payfacReference returned in the Received response of the request that triggered it.
merchantReference	nullable string	The reference you sent in the adjustment request. May be null when the adjustment was not made through the API.
amount	string	The payment amount in the minor currency unit.
currency	string	The three-letter ISO currency code.
reason	nullable string	A field that provides additional context in case of payment errors or declines, helping diagnose specific issues.
success	string	Indicates the payment status (true/false).
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.
authCode	nullable string	An authorization code is a unique series of letters or numbers generated by a card issuer or bank to validate a card payment.
cardNumber	nullable string	A partially masked PAN.
cardUsage	nullable string	The source of funds used for a payment.
originalPayfacReference	nullable string	The payfacReference of the authorization this adjustment applies to — the value you sent as payfacReference in the request. Use it to link the event to the payment.
paymentMethod	nullable string	The payment method used in the payment.