Cancel Payment Link

Update restrictions

• Only a payment link with the Status active, viewed or attempted can be cancelled.

POST Cancel Payment Link

URLs

LIVE: https://api.dnapayments.com/v1/payment-links/{id}/cancellation

TEST: https://test-api.dnapayments.com/v1/payment-links/{id}/cancellation

Creation of a payment link is achieved by sending a HTTP POST request to these URLs. The access_token will be the one received in the Authentication Response.

HTTP Headers

HTTP Header
Field Name	State	Data Type	Description
Content-Type	Mandatory	String	application/json
Authorization	Mandatory	String	Bearer access_token

URL Parameters

HTTP Header
Field Name	State	Data Type	Description
id	Mandatory	String	The Payment Link ID from a previous response.

Cancel Payment Link Response

If the request is successful, you will receive a 200 OK response code, and the following response fields.

Field name	Type	Description
id	String	Payment link ID, the unique reference for this payment link assigned by the DNA Platform.
amount	Float	The amount of the payment, as a decmal.
currency	String	Currency e.g. GBP.
invoiceId	String	The InvoiceId supplied in the Request, if applicable.
terminalId	String	The terminal ID supplied in the request.
customerName	String	The Customer name.
description	String	The description as supplied in the request.
createdDate	String	The date that the Payment Link was created.
expirationDate	String	The date that the Payment Link will expire.
viewedDate	String	The date that the Payment Link was viewed. Null if not applicable.
attemptedDate	String	The date that the Payment Link was attempted. Null if not applicable.
paidDate	String	The date that the Payment Link was viewed. Null if not applicable.
cancelledDate	String	The date that the Payment Link was viewed. Null if not applicable.
status	String	Payment link status. See Statuses for more details.
url	String	Full payment link URL

Example Request and Response

Request

POST https://api.dnapayments.com/v1/payment-links/69lXLdv9w/cancellation
HTTP/1.1

Content-Type: application/json
Authorization: Bearer 6945595921271780
User-Agent: PostmanRuntime/7.26.8
Accept: */*
Host: 192.168.0.75:8080
Accept-Encoding: gzip, deflate, br
Connection: keep-alive

Response

{
    "id": "69lXLdv9w",
    "amount": 1,
    "currency": "GBP",
    "invoiceId": "PL-1605200674803",
    "terminalId": "4511a14f-61a3-4449-a1c1-7a314ee2374c",
    "customerName": "Yermek",
    "description": "For cappuccino",
    "createdDate": "2020-11-12T17:05:31.113207Z",
    "expirationDate": "2020-11-13T17:20:50.493Z",
    "viewedDate": null,
    "attemptedDate": null,
    "paidDate": null,
    "cancelledDate": "2020-11-12T17:15:46.691161159Z",
    "status": "cancelled",
    "url": "https://test-pay.dnapayments.com/checkout/?r=69lXLdv9w"
}