Cancel full authorization

Request

If you don't want to proceed with a payment, you can send a full cancel request.

Note: You can only cancel a payment which is authorized. If the payment is settled, you must create a refund.

Security

BasicAuth

Path

linkDatastringrequired

Action link that's received in your request.

Content-Typestringrequired

Example:application/vnd.worldpay.payments-v7+json

Acceptstringrequired

Example:application/vnd.worldpay.payments-v7+json

Bodyapplication/vnd.worldpay.payments-v7+json

referencestring, [ 1 .. 128 ] characters^[-A-Za-z0-9]*$

A reference generated by you to identify a payment throughout its lifecycle.

Example:"full-cancellation-reference"

{
  "reference": "full-cancellation-reference"
}

Responses

The cancellation request has been accepted

Bodyapplication/vnd.worldpay.payments-v7+json

_linksobject

Response

Response to cancel an authorization

{
  "_links": {
    "cardPayments:events": {
      "href": "/payments/events/:linkData"
    },
    "curies": [
      {
        "name": "payments",
        "href": "/rels/payments/{rel}",
        "templated": true
      }
    ]
  }
}