# Get a payment

Source: https://developers.weerom.com/docs/reference/payments/getPayment

```http
GET https://api.weerom.com/v1/payments/{id}
```

One payment by its id, which is the id of the booking it settled. Answers 404 while the booking is unpaid.

**Keys:** a key that may read. A public key gets 403.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes | The object's id. |

## Responses

### 200

The request worked.

| Field | Type | Description |
| --- | --- | --- |
| `amount_cents` | integer | What the customer paid for the service, VAT included. |
| `booking_code` | string | The short code the customer sees on the booking. |
| `booking_id` | string (uuid) | The booking this payment settled. |
| `currency` | string | ISO 4217 code of every amount on this object. |
| `customer` | object | Who the booking is for, as written on the booking when it was made. |
| `customer.email` | string or null |  |
| `customer.id` | string (uuid) or null | Null when the customer record was erased. |
| `customer.name` | string |  |
| `customer.phone` | string or null |  |
| `description` | string | The service's name, for an invoice line. |
| `discount_percent` | integer | Percent off the list price from a deal. 0 without one. |
| `id` | string (uuid) | The payment's id. The same value as `booking_id`. |
| `list_price_cents` | integer | The price before any deal or change at the chair. |
| `method` | string or null | How they paid. Null when staff did not say. |
| `net_cents` | integer | `amount_cents` without VAT, rounded half up. |
| `object` | `payment` |  |
| `paid_at` | string (date-time) | When staff noted the payment. |
| `service_id` | string (uuid) or null | The service's id. Null when the shop deleted the service since. |
| `staff_id` | string (uuid) | Who did the work. |
| `starts_at` | string (date-time) | When the appointment started. |
| `tip_cents` | integer | Not part of `amount_cents`. |
| `vat_cents` | integer | The VAT inside `amount_cents`. |
| `vat_percent` | number | The shop's VAT rate on services as it is set today. 0 for a shop under an exemption. |

Example:

```json
{
  "amount_cents": 4000,
  "booking_code": "UEAMEFC9",
  "booking_id": "0b6f2a4e-5d1c-4f7a-9a3e-2c8d1e6f4b90",
  "currency": "EUR",
  "customer": {
    "email": "lotte@example.com",
    "id": "5f0c9d3a-7b2e-4c61-8a4d-9e1f3b6c2d75",
    "name": "Lotte Peeters",
    "phone": "+32470123456"
  },
  "description": "Knippen en baard",
  "discount_percent": 0,
  "id": "0b6f2a4e-5d1c-4f7a-9a3e-2c8d1e6f4b90",
  "list_price_cents": 4000,
  "method": "bancontact",
  "net_cents": 3306,
  "object": "payment",
  "paid_at": "2026-11-21T10:12:40.000Z",
  "service_id": "c2a41f6e-8d3b-4e97-b5a0-1f7c9e2d4a68",
  "staff_id": "8e1d5b7c-3a9f-4d20-b6c4-7a2e0f9d1c53",
  "starts_at": "2026-11-21T09:30:00.000Z",
  "tip_cents": 200,
  "vat_cents": 694,
  "vat_percent": 21
}
```

### 400

A parameter or a field is missing or malformed.

### 401

No key, an unknown key or a revoked key.

### 403

The shop's plan does not include the API, or this kind of key may not call this.

### 404

No object with this id in the key's shop.

### 429

Too many requests. Retry-After says when.

Every error answers `{ "error": { "code", "message", "param", "request_id" } }`. `param` is only on some 400 answers. See [Errors](https://developers.weerom.com/docs/errors).

## Keys

A read key or a write key. A public key answers 403 `key_not_allowed`.

## What it does

- A payment's id is the id of the booking it settled. A booking without a noted payment answers 404 here.
- `net_cents` and `vat_cents` are worked out on each read, at the shop's VAT rate as it is set at that moment.

## When a field is null

- `method` is `null` when no method was recorded with the payment.
- `service_id` is `null` when the booking is not linked to a service record. The name written on the booking still shows.
- `customer.id` is `null` when the shop erased the customer's record. The booking keeps the name, email and phone written on it.
- `customer.email` is `null` when the booking holds no email. Staff may book without one.
- `customer.phone` is `null` when the booking holds no phone number.

## Errors

Besides 401 for a missing, unknown or removed key, 403 `plan_required`, 429 `rate_limited` and 500 `internal_error`, which every endpoint can answer:

| Status | `code` | When | What to do |
| --- | --- | --- | --- |
| 404 | `not_found` | No object has this id, or the id is not a UUID. | Check the id. Ids are UUIDs from a list or from an earlier answer. |
