Skip to main content

Terminal removed event

This webhook event is triggered when a terminal has been removed or deactivated from a merchant account, indicating that the terminal is no longer available for processing new transactions. The event provides terminal identification details, merchant information, and contract references for proper terminal cleanup and system updates.

Webhook Example

{
"partnerContractNumber": "73538280",
"ssn": "1111111119",
"merchantNumber": "7366746",
"contractNumber": "32305",
"mid": "2913122972",
"tid": "3fdd19ef",
"terminalIdentifier": "3703ed39e197",
"hmacSignature": "Z3FZxGhaGu0w9tm+xBEtw/laiXr4QPRQMn0YWERrjOs=",
"additionalData": {
"eventType": "TerminalRemoved",
"eventTime": "2025-09-19T10: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.

FieldTypeDescription
partnerContractNumberstringUnique identifier of partner contract that links the terminal to a specific partner agreement.
ssnstringThe merchant SSN.
merchantNumberstringUnique identifier for the merchant account to which the terminal is being added.
contractNumberstringUnique identifier of the merchant contract associated with the terminal.
midstringUnique identifier assigned to the store.
tidstringUnique indetifier assigned to the added terminal device.
terminalIdentifiernullable stringUnique terminal identifier used in payment gateway API calls to identify terminal.
hmacSignaturestringA cryptographic signature generated using a secret, enabling verification of the message authenticity and ensuring it hasn’t been tampered with.
additionalDataobjectAn object for the additional details included in the event.

Additional Data Fields

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

FieldTypeDescription
eventTypestringA string representing the type of event that occurred.
eventTimestringISO 8601 timestamp indicating when the terminal addition event occurred.