Get the app Map (opens in a new tab)List your business

Developers

AccountingComing soon

For accounting systems: read each merchant's sales day by day per branch, with refunds and bank payouts, in figures that match the merchant's account.

Coming soonThe Partner API is not open yet. These docs are here so you can plan your integration; hosts and keys are issued at launch.Register as a developer →

On this page

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 open until it closes the next morning, then becomes closed and you receive accounting.day_closed.
  • A closed day never changes. A late refund or a correction appears in adjustments on the day it happened, with the original order and date.

Daily sales

GET /accounting/daily?merchant_id={merchant_id}&date={YYYY-MM-DD}

bash
aurmap GET '/v1/accounting/daily?merchant_id=mer_5r8k2d&date=2026-10-13'
json
{
  "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
js
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);
php
$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}

json
{
  "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.