Sales API
Vippsnummer and mPOS payments can be retrieved through our APIs when you need automatic reporting, reconciliation, or bookkeeping.
These APIs are mainly relevant when a merchant works with an accounting partner or an internal integration team. They help answer two questions:
| Question | Use this API | What it gives you |
|---|---|---|
| What was sold? | Sales API | Sales context, such as sales entries, order lines, VAT, and categories. |
| What happened to the money? | Report API | Captures, refunds, fees, balances, and payouts. |
Use the two APIs together. Sales API entries can be matched with Report API entries using reference and pspReference.
What data is available​
The Sales API covers three sales types, identified by the solution field in each entry:
| Sales type | API value | What you can retrieve |
|---|---|---|
| Open Amount | VARIABLE_AMOUNT | Sales amount and sales category when available. Open Amount does not have order lines. |
| Shopping Basket | SHOPPING_BASKET | Order lines, item names, quantities, and VAT per line when the merchant has added that data. |
| mPOS | MPOS | Sales events from mPOS, including card, cash, and wallet payments when available. |
Shopping Basket VAT data depends on what the merchant has entered. VAT is not mandatory for every item, so integrations should handle missing or partial VAT data.
The Sales API does not replace settlement reporting. Use the Report API when you need payout, fee, balance, refund, or settlement details.
The Sales API does not expose customer information.
Recommended retrieval flow​
- Find the sales units you can access. Use the Report API to find the
ledgerIdvalues covered by the accounting partner agreement. - Retrieve sales data from the Sales API. Use the feed endpoint for continuous synchronization, date-based retrieval for a specific accounting date, or
referenceandpspReferencelookup for a specific sale or transaction. - Retrieve money movement data from the Report API. Fetch captures, refunds, fees, balances, and payouts.
- Match the data. Join Sales API and Report API entries using
referenceat order level orpspReferenceat transaction level. - Store cursors and synchronize regularly. Persist the cursor from each response and continue from the last cursor instead of starting over.
Historical data availability​
Sales API data is available from:
| Sales type | Data available from |
|---|---|
| mPOS | March 9, 2026, 12:45 UTC |
| Vippsnummer Open Amount | March 16, 2026, 09:28 UTC |
| Vippsnummer Shopping Basket | April 22, 2026, 11:04 UTC |
Data before these times is not available through the Sales API.
Environments​
The Sales API is available in production and UAT. It is not available in the test environment.
Next steps​
- Quick start - Authenticate and run your first requests in curl.
- API guide - Endpoints, field semantics, and the Report API mapping.
- API reference - Full endpoint specifications.