Get a payment
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.
apiKeyAuthorizationBearer wo_live_...A key from the shop's admin. Secret keys start with wo_live_, public keys with wo_pub_.
id*stringThe object's id.
uuidThe request worked.
application/json- response
A booking a customer paid for at the chair. WeerOm notes the payment, it does not take the money.
amount_cents*integerWhat the customer paid for the service, VAT included.
booking_code*stringThe short code the customer sees on the booking.
booking_id*stringThe booking this payment settled.
uuidcurrency*stringISO 4217 code of every amount on this object.
customer*Who the booking is for, as written on the booking when it was made.
description*stringThe service's name, for an invoice line.
discount_percent*integerPercent off the list price from a deal. 0 without one.
id*stringThe payment's id. The same value as booking_id.
uuidlist_price_cents*integerThe price before any deal or change at the chair.
method*|nullnet_cents*integeramount_cents without VAT, rounded half up.
object*stringpaid_at*stringWhen staff noted the payment.
date-timeservice_id*|nullstaff_id*stringWho did the work.
uuidstarts_at*stringWhen the appointment started.
date-timetip_cents*integerNot part of amount_cents.
vat_cents*integerThe VAT inside amount_cents.
vat_percent*numberThe shop's VAT rate on services as it is set today. 0 for a shop under an exemption.
curl 'https://api.weerom.com/v1/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "amount_cents": 4000, "booking_code": "UEAMEFC9", "booking_id": "0b6f2a4e-5d1c-4f7a-9a3e-2c8d1e6f4b90", "currency": "EUR", "customer": { "email": "[email protected]", "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}Details
Keys
Read keyWrite key
Any other kind of 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_centsandvat_centsare worked out on each read, at the shop's VAT rate as it is set at that moment.
When a field is null
methodisnullwhen no method was recorded with the payment.service_idisnullwhen the booking is not linked to a service record. The name written on the booking still shows.customer.idisnullwhen the shop erased the customer's record. The booking keeps the name, email and phone written on it.customer.emailisnullwhen the booking holds no email. Staff may book without one.customer.phoneisnullwhen 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. Errors has all of them.
| 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. |