---
type: table
title: orders
description: One row per placed order — the durable record the whole system hangs off.
tags: [table]
database: main
timestamp: {{DATE}}
---
<!-- ✂ docujoint template sample — replace with your own content, then delete this comment. -->
# orders

## Purpose
Created by [Payments Service](</Services/Payments Service.md>) when a charge
succeeds during the [Order Placement](</Flows/Order Placement/Order Placement.md>)
flow. Status values come from [order-status](</Data/main/Enums/order-status.md>).

## Columns
| Column | Type | Nullable | Purpose |
|--------|------|----------|---------|
| id | uuid | no | Primary key |
| buyer_id | uuid | no | Who placed the order |
| status | text | no | One of [order-status](</Data/main/Enums/order-status.md>) |
| total_cents | int | no | Charged amount |
| placed_at | timestamptz | no | When the charge succeeded |

## Open questions