v1

latestOpenAPI 3.0.12026-07-14164671.7 KB

Refunding card payments

Check the status of a refund

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

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

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.

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",
  "payment_id": "hu20sqlact5260q2nanm0q8u93",
  "refund_id": "act4c33g40j3edfmi8jknab84x",
  "settlement_summary": {
    "settled_date": "2016-01-21"
  },
  "status": "success"
}