# GOV.UK Pay API

**Provider:** GOV.UK Pay
**Category:** payments
**Base URL:** `https://publicapi.payments.service.gov.uk`
**Auth:** api-key — `Authorization: YOUR_API_KEY`
**Rate Limit:** 1,000 req/min (production)
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://publicapi.payments.service.gov.uk

## Description

GOV.UK Pay API (This version is no longer maintained. See openapi/publicapi_spec.json for latest API specification)

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://publicapi.payments.service.gov.uk/v1/payments` | Search payments |
| POST | `https://publicapi.payments.service.gov.uk/v1/payments` | Create new payment |
| GET | `https://publicapi.payments.service.gov.uk/v1/payments/{paymentId}` | Find payment by ID |
| POST | `https://publicapi.payments.service.gov.uk/v1/payments/{paymentId}/cancel` | Cancel payment |
| POST | `https://publicapi.payments.service.gov.uk/v1/payments/{paymentId}/capture` | Capture payment |
| GET | `https://publicapi.payments.service.gov.uk/v1/payments/{paymentId}/events` | Return payment events by ID |
| GET | `https://publicapi.payments.service.gov.uk/v1/payments/{paymentId}/refunds` | Get all refunds for a payment |
| POST | `https://publicapi.payments.service.gov.uk/v1/payments/{paymentId}/refunds` | Submit a refund for a payment |

## Authentication

API key in the request header (Authorization)

```
Authorization: YOUR_API_KEY
```

## Sample Request

```bash
curl -X GET 'https://publicapi.payments.service.gov.uk/v1/payments' \
  -H 'Authorization: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

UK Government payment platform. Free for public sector use — no transaction fees (payment processor fees still apply via bank/card networks). Built by GDS.

---

*Source: [API Map](https://apimap.dev/apis/gov-uk-pay/) — CC BY 4.0*