---
title: "Delete Link"
method: POST
path: "/delete"
tags: ["Payment Links"]
---

# Delete Link

`POST /delete`

This API can be used to delete a previously created payment link

## Headers

- `BD-Traceid` string, required
- `BD-Timestamp` string, required
- `Content-Type` string, required
- `Accept` string, required

## Request body

- object
  - `data` object
    - `mercid` string, required — Unique identifier as defined by BillDesk for each merchant
    - `linkid` string — Unique ID generated by BillDesk for a payment link
    - `merc_link_ref_no` string — Unique reference number provided by merchant

## Response `200`

OK

- object
  - `data` object
    - `objectid` 'link' — String representing the object's type. Objects of the same type share the same value.
    - `linkid` string — Unique ID generated by BillDesk for a payment link
    - `createdon` string, date-time — object creation timestamp
    - `amount` string — Payment link amount
    - `currency` string — ISO currency of the transaction amount, for INR this value will be 356
    - `payment_method_allowed` string — Comma separated values to define payment method allowed in the payment link. Allowed values - quickpay, card, emi, nb, upi, wallets, qr, gpay, neft_rtgs, whatsapppay, cbdc or all
    - `flow_type` string — Fixed value "payment"
    - `customer` Customer
      - `first_name` string — Customer’s First Name
      - `last_name` string — Customer’s Last Name
      - `mobile` string — Customer’s Mobile number. This parameter is mandatory if sms is passed as true in customer_notification object.
      - `email` string — Customer’s Email address. This parameter is mandatory if email is passed as true in customer_notification object.
    - `customer_notification` CustomerNotificationRequest — Merchant can choose to send Email or SMS or both to the customer once payment link is generated.
      - `sms` boolean — If true, BillDesk sends a SMS notification on the mobile number provided in customer object
      - `email` boolean — If true, BillDesk sends an Email notification on the Email ID provided in customer object
    - `udf` object[] — User defined fields defined by merchant which will be displayed to the customer on link summary page. Maximum udf objects allowed are 7. Note: Merchant is advised to not pass customer PII information in UDF fields.
      - `sequence` integer — Sequence of the field to be shown on link summary page. If this value is 1, the field will be shown on top of the link summary page.
      - `field_label` string — Label of the field
      - `field_value` string — Value of the field
      - `hidden_flag` boolean — If true, the object will not be displayed on link summary page
    - `additional_info` AdditionalInfo — Array of 7 additional_info values that can be attached to the transaction. Note: Merchant is advised to not pass customer PII information in additional info fields.
      - `additional_info1` string
      - `additional_info2` string
      - `additional_info3` string
      - `additional_info4` string
      - `additional_info5` string
      - `additional_info6` string
      - `additional_info7` string
    - `forwarding_url` string — Merchant specific url where customer will be redirected post transaction is completed. Please note : transaction details will not be posted on this url.
    - `link_expiry_date` string — Expiry timestamp of the link. If not passed, the default expiry date is one month from the link creation date.
    - `link_desc` string — Merchant specific description of the link which gets displayed to the customer
    - `link_title` string — Merchant specific title of the link which gets displayed to the customer
    - `max_payments_allowed` integer — Maximum number of partial payments that can be processed on the same link. This can be a maximum value of 10 (successful transactions). Value of 1 indicates a single payment can be collected against the link.
    - `partial_payment_allowed` boolean — To determine if partial payment is allowed on the link against the total amount used for link creation.
    - `minimum_partial_amount` string — Value equal to amount indicates a single payment can be collected against the link.
    - `link` string — Payment link generated where customer must be redirected for payment
    - `link_status` 'ISSUED' | 'ATTEMPTED' | 'PAID' | 'PARTIALLY PAID' | 'EXPIRED' | 'DELETED' — Status of payment link

## Other responses

- `403` — Forbidden
- `500` — Internal Server Error
- `default` — Any bad or invalid request will lead to following error object

---

[API](https://skmtc.net/billdesk/apis/payments.md) · [All operations](https://skmtc.net/billdesk/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/billdesk/payments/revisions/43f021fc467f/schema)