Webhook Notifications

Overview

It is possible to set up a notification URL where a POST request will be made with transaction result in JSON format. Notification URL is set during merchant onboarding. Notifications may be sent multiple times during transaction lifecycle if 3D Secure is enabled. A regular 200 OK response is expected as a response. Notifications will not be repeated even if no response is returned.

Verification

in addition to the transaction result a SHA256 digest is sent allowing for verification of message. The digest is calculated by concatenating the following fields: icsid + userid + storeid + tracking_id + timestamp_utc

Example notification

Example JSON notification

{
  "version": "3.0",
  "cardtype": "CC",
  "timestamp": "2022-02-01 00:00:00",
  "timestamp_utc": "2022-02-01 00:00:00",
  "status": 2,
  "resultcode": "00",
  "resulttext": "Approved",
  "resultstatus": "Approved",
  "trackingid": "235896eaa7e6497a9fec0283487_test",
  "transtype": "NA",
  "ordernumber": "235896eaa7e6497a_101",
  "currency": "USD",
  "amount": "22.11",
  "authcode": "test_auth_code",
  "digest": "65f8956e9a11896c43c33ae45b2f8cdbaa00011832fc1c0c7f43b9f3b8cd9db4"
}