When you receive an EHN from us you will always receive the following fields:
| Property | Type | Description |
|---|---|---|
EVENT_TYPErequired | string | A string literal indicating the type of notification being sent. |
EVENT_TIMESTAMPrequired | datetime | UTC timestamp of when the event occurred. Example: 2016-11-06 12:22:19Z |
DELIVERY_TIMESTAMPrequired | datetime | UTC timestamp of when this notification delivery is being attempted. Example: 2016-11-06 12:22:19Z |
MERCHANT_IDrequired | int | The ID of the merchant account for which the event occurred. |
Digestrequired | string(40) | A SHA-1 hash to be used in verifying the message's origin. Please see the order in the Digest Calculation Order below. |
Digest Calculation Order:
| Position | Field |
|---|---|
| 1 | EVENT_TYPE |
| 2 | EVENT_TIMESTAMP |
| 3 | DELIVERY_TIMESTAMP |
| 4 | MERCHANT_ID |
| 5 | Secret Key (provided to you with your account credentials) |
The above fields are concatenated using a semicolon ";" as a separator.
The SHA-1 hash is calculated on the resulting UTF8-encoded string.