Event Types
This section provides an overview of all webhook event types related to merchant management in the Straumur payment system. These events notify your system about changes to merchant account configurations, particularly terminal management activities.
Terminal added event
This webhook event is triggered when a new terminal has been added to a merchant account, indicating that a new payment terminal is now available for processing transactions. The event provides terminal identification details, merchant information, and contract references for proper terminal management and integration.
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.
Contract linked event
This webhook event is triggered when a merchant contract has been linked to a partner contract, indicating that the merchant is now associated with the partner agreement for billing and reporting purposes. Unlike the terminal events, a single contract may have multiple terminals attached at the time of linking, so the payload includes a terminals array describing every terminal currently active on the contract.
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.
HMAC Signature
By validating the HMAC signature, your system can verify that messages are genuinely from the Straumur and have not been altered in transit.