Skip to main content

Cancel a payment API reference

This page is part of GOV.UK Pay’s API reference and is an index of the following you’ll use when cancelling a payment:

  • parameters
  • example requests
  • example responses

You can also read more about how cancelling payments fits into the process for taking a payment in our task-based guidance.

The URL for this endpoint is:


You can use this endpoint to cancel a payment.

The data from this endpoint is strongly consistent, meaning it is updated immediately after you make any changes. You can read more about data consistency in our API.

Path parameters for ‘Cancel a payment’

Name Type Description
{PAYMENT_ID} (required) string The ID of the payment you’re cancelling.

GOV.UK Pay associates a unique paymentId with a payment when you create that payment.

Example request for ‘Cancel a payment’

This example request cancels the payment with the payment ID hu20sqlact5260q2nanm0q8u93:

curl -X POST "" -H "Authorization: Bearer api_test_123abc456def"

You do not need to send anything in the body of requests to this endpoint.

Example response for ‘Cancel a payment’

A successful payment cancellation returns a 204 HTTP status code without a response body.

You can read more about HTTP status codes and their meaning in the GOV.UK Pay API.