Sign in

v1

latestOpenAPI 3.0.02026-07-2431146358.7 KB
Payment Links

Retrieve Link

This API can be used to fetch the status of an existing payment link

post/fetch

Headers

BD-Traceidstring required
Example:20201203182838

BD-TraceID is a unique identifier passed by the merchant to ensure request idempotency. Requests with identical BD-TraceID within a 24 hour window would fail.

BD-Timestampstring required
Example:20201203182838

Request timestamp to identify date and time of origin of request. Example, a value of BD-Timestamp 20210113180403 identifies the request to have originated on 13th January 2021 at 06:04:03 PM.

Content-Typestring required
Example:application/json

Request Content-Type to take the values application/jose

Acceptstring required
Example:application/jose

Accept Response Content-Type to take the values application/jose

Request body

Example request

{
  "data": {
    "mercid": "BDMERCID",
    "linkid": "LP20240701lepFL",
    "merc_link_ref_no": "testlink01"
  }
}

Response

OK

Example response

{
  "data": {
    "mercid": "BDMERCID",
    "merc_link_ref_no": "testlink01",
    "linkid": "LP20240701lepFL",
    "link_expiry_date": "2024-08-14T17:57:31.262889064",
    "link_desc": "Apparel - Format shirt, Trousers - 4 nos.",
    "link_title": "Instagram Purchase",
    "forwarding_url": "https://www.merchant.com",
    "payment": {
      "amount": "299.28",
      "amount_pending": "100.00",
      "minimum_partial_amount": "299.28"
    },
    "total_attempts": "3",
    "transaction_list": [
      {
        "transactionid": "U4560001099939",
        "amount": "299.28",
        "transaction_date": "2023-03-14T15:14:39+05:30"
      }
    ]
  }
}