Contract unlinked event

This webhook event is triggered when a merchant contract has been unlinked from a partner contract, indicating that the merchant is no longer associated with the partner agreement for billing and reporting purposes. Unlike the contract linked event, no terminal list is included — the payload only contains the identifiers of the parties involved in the separation.

Webhook Example

{
    "partnerContractNumber": "73538280",
    "ssn": "1111111119",
    "merchantNumber": "7366746",
    "contractNumber": "32305",
    "hmacSignature": "G8MRsh6OAZf+anQ+0VWcp3PNRNVBqxmpW3mOimqmbdM=",
    "additionalData": {
        "eventType": "ContractUnlinked",
        "eventTime": "2026-05-28T10:14:46.6730082Z"
    }
}

info

HMAC key: e3cb3ecddce4e190713b89d84e618b46adb64400291f2002

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
partnerContractNumber	string	Unique identifier of the partner contract the merchant contract has been unlinked from.
ssn	string	The merchant SSN.
merchantNumber	string	Unique identifier for the merchant account whose contract was unlinked.
contractNumber	string	Unique identifier of the merchant contract that was unlinked from the partner contract.
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.
eventTime	string	ISO 8601 timestamp indicating when the contract was unlinked.

HMAC Signature

The HMAC signature for ContractUnlinked uses the same four-field signing path as ContractLinked.

The signing order is: PartnerContractNumber, Ssn, MerchantNumber, ContractNumber.

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