API reference
Receipts and POS
A receipt is created when an order becomes paid or overpaid, at https://. Point-of-sale devices are paired in the dashboard by a signed-in member; the API lists them so that orders with source: "pos" can be attributed.
The receipt object
JSON
{
"id": "rcpt_ppaxx20nbqv0kqgkwcxcc5xh",
"object": "receipt",
"livemode": true,
"created": "2026-10-11T14:09:55.764Z",
"number": "R-000913",
"order": "ord_0zymngngvf12b8b2cra7tb8e",
"url": "https://pay.orrerie.com/r/rcpt_ppaxx20nbqv0kqgkwcxcc5xh",
"pdf": "file_bged6qxyg8ntsnnaajz3gjsw",
"sent_to": "jane@example.com",
"sent_at": "2026-10-11T14:09:57.100Z"
}The pos_device object
JSON
{
"id": "pos_zhxsff7zdsj8k6tshhkns7df",
"object": "pos_device",
"livemode": true,
"created": "2026-09-20T12:00:00.000Z",
"label": "Front counter tablet",
"status": "paired",
"paired_by": "mem_re2bmvrnbzsbefcwx64ftp5w",
"display_url": "https://pay.orrerie.com/pos/pos_zhxsff7zdsj8k6tshhkns7df",
"last_seen_at": "2026-10-11T13:58:00.000Z"
}| Field | Meaning |
|---|---|
status | One of paired, revoked. |
Every field
Fields of the receipt object
| Field | Type | Meaning |
|---|---|---|
id | string | Unique identifier: the object prefix, an underscore, 24 lower-case Crockford base32 characters. |
object | string | The type of this object. |
livemode | boolean | true for live mode (real money); false for test mode (simulated payments). |
created | string (date-time) | When the object was created. RFC 3339, UTC, milliseconds. |
number | string | The receipt number. |
order | string | The ord_ id the receipt is for. |
url | string | The receipt's page on the payer site. |
pdf | string or null | The file_ id of the receipt's PDF; null until it is made. |
sent_to | string or null | The email the receipt was sent to; null when it was not sent. |
sent_at | string (date-time) or null | When it was sent; null when it was not. |
Fields of the pos_device object
| Field | Type | Meaning |
|---|---|---|
id | string | Unique identifier: the object prefix, an underscore, 24 lower-case Crockford base32 characters. |
object | string | The type of this object. |
livemode | boolean | true for live mode (real money); false for test mode (simulated payments). |
created | string (date-time) | When the object was created. RFC 3339, UTC, milliseconds. |
label | string | The till's name, as the merchant set it. |
status | string | One of paired, revoked. |
paired_by | string | The mem_ id of the member who paired it. |
display_url | string | The page the till shows to payers. |
last_seen_at | string (date-time) or null | When the device last reached Orrerie; null until it has. |
Endpoints
- GETRetrieve a receipt/v1/receipts/{id}
- POSTEmail a receipt/v1/receipts/{id}/send
- GETList point-of-sale devices/v1/pos_devices
Events
Webhook events whose data.object is an object of this page.