GOgovernment-digital-service
Refunding card payments

Check the status of a refund

Changed on

You can use this endpoint to get details about an individual refund.

get/v1/payments/{paymentId}/refunds/{refundId}

Request

  • Base URL
    https://publicapi.payments.service.gov.uk
  • URL
    https://publicapi.payments.service.gov.uk/v1/payments/{paymentId}/refunds/{refundId}
  • Auth
    HTTP bearer

Path parameters

paymentIdstring required

The unique payment_id of the payment you want to view a refund of.

refundIdstring required

The unique refund_id of the refund you want to view. If one payment has multiple refunds, each refund has a different refund_id.

Response

OK - your request was successful.

amountinteger

The amount refunded to the user in pence.

created_datestring

The date and time you created this refund. This value uses Coordinated Universal Time (UTC) and ISO 8601 format - YYYY-MM-DDThh:mm:ss.SSSZ.

feeinteger

The fee, in pence, charged for processing the refund.

net_amountinteger

The net amount, in pence, associated with the refund, including any fee applicable.

payment_idstring

The unique ID GOV.UK Pay automatically associated with this payment when you created it.

refund_idstring

The unique ID GOV.UK Pay automatically associated with this refund when you created it.

status'submitted' | 'success' | 'error'

The status of the refund.

Example response

{
  "_links": {
    "payment": {
      "href": "https://an.example.link/from/payment/platform",
      "method": "GET"
    },
    "self": {
      "href": "https://an.example.link/from/payment/platform",
      "method": "GET"
    }
  },
  "amount": 120,
  "created_date": "2017-01-10T16:52:07.855Z",
  "fee": 2,
  "net_amount": -122,
  "payment_id": "hu20sqlact5260q2nanm0q8u93",
  "refund_id": "act4c33g40j3edfmi8jknab84x",
  "settlement_summary": {
    "settled_date": "2016-01-21"
  },
  "status": "success"
}

Changes

  • 6dc4b2c91eb8Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • eafdca6d5023Revision changes
    • info

      added the optional property to the response with the status