Endpoints and scopes
| Request | Scope |
|---|---|
GET /accounting/daily |
accounting:read |
GET /accounting/orders |
accounting:read |
GET /accounting/payouts |
accounting:read |
GET /accounting/payouts/{payout_id} |
accounting:read |
Who this page is for
Accounting and invoicing systems. The merchant links you at merchant level with accounting:read, so you see all their branches. See Linking.
This group is coming soon.
The accounting day
- A day is counted in each branch’s time zone.
- A day stays
openuntil it closes the next morning, then becomesclosedand you receiveaccounting.day_closed. - A closed day never changes. A late refund or a correction appears in
adjustmentson the day it happened, with the original order and date.
Daily sales
GET /accounting/daily?merchant_id={merchant_id}&date={YYYY-MM-DD}
aurmap GET '/v1/accounting/daily?merchant_id=mer_5r8k2d&date=2026-10-13'{
"merchant_id": "mer_5r8k2d",
"date": "2026-10-13",
"currency": "SAR",
"status": "closed",
"places": [
{
"place_id": "plc_9q3w7e",
"timezone": "Asia/Riyadh",
"orders": { "completed": 42, "cancelled": 3, "rejected": 1 },
"gross_sales_minor": 186450,
"discounts_minor": 4000,
"refunds_minor": 5405,
"net_sales_minor": 177045,
"tax_minor": 23093,
"by_payment_method": { "card": 151200, "cash": 25845 },
"adjustments": []
}
]
}| Field | Description |
|---|---|
gross_sales_minor |
completed orders before discounts |
discounts_minor |
discounts |
refunds_minor |
what was refunded to customers that day |
net_sales_minor |
net sales |
tax_minor |
tax within sales |
by_payment_method |
net sales by payment method |
aurmap_fees_minor |
integer, in halalas |
aurmap_fees_tax_minor |
integer, in halalas |
cash_fees_due_minor |
integer, in halalas |
payable_to_merchant_minor |
what the merchant is owed for the day |
adjustments[] |
corrections that belong to earlier days |
const day = await aurmap('GET', `/v1/accounting/daily?merchant_id=${merchantId}&date=2026-10-13`);
for (const p of day.places) postJournal(p.place_id, day.date, p);$day = aurmap('GET', "/v1/accounting/daily?merchant_id={$merchantId}&date=2026-10-13");
foreach ($day['places'] as $p) {
post_journal($p['place_id'], $day['date'], $p);
}Order by order
GET /accounting/orders?merchant_id=&date=&cursor= returns one line per order with the same columns, for line-level reconciliation.
Payouts
GET /accounting/payouts?merchant_id=&from=&to= and GET /accounting/payouts/{payout_id}
{
"payout_id": "pay_3t9w1z",
"merchant_id": "mer_5r8k2d",
"period": { "from": "2026-10-07", "to": "2026-10-13" },
"amount_minor": 1012340,
"currency": "SAR",
"status": "paid",
"paid_at": "2026-10-14T09:12:00Z",
"bank_reference": "TRX-20261014-55821",
"iban_last4": "4410",
"days": ["2026-10-07", "2026-10-08", "2026-10-09", "2026-10-10", "2026-10-11", "2026-10-12", "2026-10-13"]
}Statuses: scheduled, paid, failed. You also receive payout.created and payout.paid.