Skip to main content

Merchant and Contract Status Changed Webhook Events

Two new merchant management webhook events are now available: Merchant Status Changed and Contract Status Changed. They let partners react when a merchant or one of its contracts is enabled or disabled.

What's included

The ContractStatusChanged event fires whenever a single merchant contract is enabled or disabled. It carries the same identifiers as ContractLinked/ContractUnlinkedpartnerContractNumber, ssn, merchantNumber, and contractNumber — plus a new additionalData.status field set to Enabled or Disabled.

The MerchantStatusChanged event fires whenever a merchant itself is enabled or disabled. Since a merchant can have multiple contracts linked to the same partner contract, this event is sent once per partner contract and lists every linked contract in a new additionalData.contractNumbers array, instead of a single contractNumber.

HMAC signature

The HMAC signature for ContractStatusChanged is calculated over PartnerContractNumber, Ssn, MerchantNumber, ContractNumber — the same four-field signing path used by ContractLinked and ContractUnlinked.

MerchantStatusChanged is not raised for a single contract, so its signature only covers PartnerContractNumber, Ssn, MerchantNumber.

See the full documentation at Merchant Status Changed Event and Contract Status Changed Event.