Webhooks

A webhook is an event driven notification from Blink to your system. Webhooks are also known as callback or return URL.

The return webhook is triggered when the payment has been processed and the notification webhook is triggered when the transaction status is changed in Blink.

The user is redirected to the return_url or notification_url specified in the intent request.

The return webhook passes a parameter called res in the URL. This res is the transaction_id in base64_encoded format, which you need decode using base64_decoded.

Resources

POST <return_url>?res=12345
POST <notification_url>

Return Webhook

GET https://<return_url>?res=12345

Request

GET https://my_domain/return?res=BL-5TYAU56 HTTP/1.1

Response

HTTP/1.1 200 OK

Notification Webhook

POST https://<notification_url>

Headers

Content-Type string
Content type is JSON.

Attributes

transaction_id string
Transaction id.

status string
The new status of the transaction.

note string
Notification note.

merchant_data json
JSON string of all the optional data sent by the merchant.

Request

POST https://my_domain/notification HTTP/1.1
Content-Type: application/json

{
    "transaction_id": "BL-****",
    "status": "Captured",
    "note": "Status changes to Captured",
    "merchant_data": {
      "order_id": 1234567
    }
}

Response

HTTP/1.1 200 OK