Merchant Management Service
Getting Started
Notification

Notification

Configure outgoing webhooks

Purpose

  • HTTP-based real-time push notifications.
  • Used for instant status communication.
  • Vital for reconciliation issues, and improving user experience.

Configuring

Step 1: Create an Endpoint on Your Server

Set up an HTTPS or HTTP endpoint with a URL that will receive POST requests with JSON payload.

Step 2: Configure Webhook Endpoint on MineSec Dashboard

Go to "Acquirer Profile" menu -> Edit. Configure the endpoint created in step 1 in Notification URL.

Notification policy:

  • The request timeout is 20 seconds
  • The method is POST
  • Success is determined by judging the return of HttpStatus.HTTP_OK (200)
  • If the notification fails, a second notification will be sent. If the second notification fails, send up to three times, finish the notification.
  • The default notification interval is 0s, 20s, and 40s.
  • timestamp as common parameter, the time is the request time, in milliseconds since the Unix epoch.

Endpoint Format:

https://{authority}/{path}?{query}
  • authority: Is the domain name of the server
  • path: consisting of a sequence of path segments separated by a slash (/). A path is always defined for a URI, though the defined path may be empty (zero length).
  • query: An optional query component preceded by a question mark (?). If Endpoint want know the request is from MineSec, you can add query parameter, such as ?source=minesec

Notification

Notification will happen after MineSec request acquire host, before request acquire host have some steps for checking the basic configuration, such as the device is valid, the acquirers is valid, etc. If the basic configuration is not valid, the notification will not be sent. After the basic configuration is valid, the notification will be sent according to the following types.

the parameter can refer Service API get order detail information.

transaction format

{
 
  "tranId": "M1808047472455491586",
  "cvmPerformed": "NO_CVM",
  "tsi": "0000",
  "mcc": "",
  "merchantName": "2C2P",
  "tranStatus": "DECLINED",
  "tranType": "SALE",
  "atc": "01B4",
  "createdAt": "1719878285879",
  "trace": "491586",
  "acqMid": "065240116000002",
  "callbackUrl": "https://webhook.site/a74559cf-2512-4287-bf1b-222bdc249e8d",
  "entryMode": "NFC",
  "updatedAt": "1719878291684",
  "amount": "{\"currency\":\"SGD\",\"value\":1}",
  "batchNo": "101318",
  "appName": "5649534120435245444954",
  "linkedTranId": "M1808047472455491586",
  "acqTid": "90004300",
  "merchantAddr": "",
  "rrn": "407020000174",
  "tc": "437484CAB4A9557A",
  "tvr": "0000000000",
  "accountMasked": "**** **** **** 2377",
  "sdkId": "515cd36f3f09bfc2",
  "paymentMethod": "VISA",
  "hostMessageFormat": "MS_ENABLER",
  "notifyId": 1433,
  "aid": "A0000000031010"
}

Testing

Use https://webhook.site/ (opens in a new tab) generate a test endpoint.

Quickstart GuidePBO Owner