POS-API · Endpoints
Ordrer, menukort og point
Hvert endpoint med parametre, et kald i curl, Node, C# og PHP og et eksempel på svaret. Eksemplerne bruger det miljø, I har valgt, og et opdigtet company_id.
Base-URL
https://api.walletplus.dk/api/pos/v1Kræver en nøgle, der starter med wp_live_.
Endpoint
Hent ordrer
/ordersKræver orders:readOrdrerne sorteret efter hvornår de sidst blev ændret. Det er dette kald, I holder jer i sync med: første gang med updated_since, derefter altid med cursoren fra forrige svar. Kontantordrer er med fra start, kort- og MobilePay-ordrer først når betalingen er gået igennem.
Sådan holder I jer i sync
- 1
Første kald
Sætupdated_sincetil det tidspunkt, I vil have historik fra. - 2
Gem next_cursor
Læg den i jeres egen database — ikke kun i hukommelsen. - 3
Alle senere kald
Sendcursor, og dropupdated_sincehelt. - 4
Er has_more true?
Så kald igen med det samme — I er bagud.
Den fejl der koster ordrer
updated_since ud fra jeres eget ur. Går jeres server to minutter foran vores, springer I to minutters ordrer over — og ingen opdager det. Cursoren har ikke det problem. En annulleret ordre forsvinder ikke; den får status: "cancelled". Kort- og MobilePay-ordrer kommer først med, når betalingen er gået igennem.| Felt | Hvor | Type | Beskrivelse |
|---|---|---|---|
| company_idpåkrævet | query | uuid | Virksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang. |
| updated_since | query | ISO 8601 | Første kald: ordrer ændret siden dette tidspunkt. Udelades, når I sender cursor. |
| cursor | query | string | next_cursor fra forrige svar. Gem den i jeres egen database. |
| status | query | liste | Kommasepareret, fx confirmed,ready. Udeladt betyder alle. |
| limit | query | 1–200 | Antal pr. side. Standard 50. |
curl -s "https://api.walletplus.dk/api/pos/v1/orders?company_id=3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d&updated_since=2026-09-24T08%3A00%3A00Z&limit=50" \
-H "Authorization: Bearer $WALLETPLUS_KEY"{
"data": [
{
"id": "7c1f2a90-4b1e-4e0a-9c6d-2f8e1a3b5c7d",
"order_number": "1042",
"company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
"status": "confirmed",
"order_type": "pickup",
"currency": "DKK",
"subtotal_minor": 15950,
"discount_minor": 0,
"points_discount_minor": 0,
"delivery_fee_minor": 0,
"packaging_fee_minor": 0,
"service_fee_minor": 0,
"total_minor": 15950,
"refunded_amount_minor": 0,
"payment_method": "card",
"payment_status": "paid",
"points_used": 0,
"customer": {
"id": "c41a7e20-6b3d-4f8a-a1c9-0d2e3f4a5b6c",
"name": "Mette Jensen",
"phone": "+4512345678",
"email": "mette@example.dk"
},
"note": null,
"allergy_note": "Ingen nødder",
"delivery_note": null,
"delivery_address": null,
"scheduled_for": null,
"pickup_time": "18:30",
"cancel_reason": null,
"created_at": "2026-09-24T10:05:00.000Z",
"updated_at": "2026-09-24T10:05:00.000Z",
"lines": [
{
"id": "0b8e6f14-2c3d-4e5f-8a9b-1c2d3e4f5a6b",
"sku": "12",
"product_id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
"product_name": "Margherita",
"variant_name": "Stor",
"category_name": "Pizza",
"quantity": 2,
"unit_price_minor": 7975,
"line_total_minor": 15950,
"options": [
{
"group": "Ekstra",
"name": "Ekstra ost",
"price_minor": 0
}
],
"bundle_instance_id": null,
"bundle_role": null
}
]
}
],
"next_cursor": "eyJ2IjoxLCJ1IjoiMjAyNi0wOS0yNFQxMDowNTowMC4wMDBaIiwiaSI6IjdjMWYifQ",
"has_more": false,
"server_time": "2026-09-24T10:06:12.084Z"
}Endpoint
Hent én ordre
/orders/{orderId}Kræver orders:readÉn ordre med alle linjer. Bruges typisk efter en webhook, som kun bærer ordrens id og status.
| Felt | Hvor | Type | Beskrivelse |
|---|---|---|---|
| orderIdpåkrævet | sti | uuid | Ordrens id. |
| company_idpåkrævet | query | uuid | Virksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang. |
curl -s "https://api.walletplus.dk/api/pos/v1/orders/%3Cordre-id%3E?company_id=3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d" \
-H "Authorization: Bearer $WALLETPLUS_KEY"{
"data": {
"id": "7c1f2a90-4b1e-4e0a-9c6d-2f8e1a3b5c7d",
"order_number": "1042",
"company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
"status": "confirmed",
"order_type": "pickup",
"currency": "DKK",
"subtotal_minor": 15950,
"discount_minor": 0,
"points_discount_minor": 0,
"delivery_fee_minor": 0,
"packaging_fee_minor": 0,
"service_fee_minor": 0,
"total_minor": 15950,
"refunded_amount_minor": 0,
"payment_method": "card",
"payment_status": "paid",
"points_used": 0,
"customer": {
"id": "c41a7e20-6b3d-4f8a-a1c9-0d2e3f4a5b6c",
"name": "Mette Jensen",
"phone": "+4512345678",
"email": "mette@example.dk"
},
"note": null,
"allergy_note": "Ingen nødder",
"delivery_note": null,
"delivery_address": null,
"scheduled_for": null,
"pickup_time": "18:30",
"cancel_reason": null,
"created_at": "2026-09-24T10:05:00.000Z",
"updated_at": "2026-09-24T10:05:00.000Z",
"lines": [
{
"id": "0b8e6f14-2c3d-4e5f-8a9b-1c2d3e4f5a6b",
"sku": "12",
"product_id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
"product_name": "Margherita",
"variant_name": "Stor",
"category_name": "Pizza",
"quantity": 2,
"unit_price_minor": 7975,
"line_total_minor": 15950,
"options": [
{
"group": "Ekstra",
"name": "Ekstra ost",
"price_minor": 0
}
],
"bundle_instance_id": null,
"bundle_role": null
}
]
}
}Endpoint
Hent virksomheden
/companyKræver company:readStamdata, ordretyper, pointsats og åbningstider. Ugedagene tælles fra 0 = mandag til 6 = søndag.
| Felt | Hvor | Type | Beskrivelse |
|---|---|---|---|
| company_idpåkrævet | query | uuid | Virksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang. |
curl -s "https://api.walletplus.dk/api/pos/v1/company?company_id=3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d" \
-H "Authorization: Bearer $WALLETPLUS_KEY"{
"data": {
"id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
"name": "Pizzeria Eksempel",
"slug": "pizzeria-eksempel",
"address": "Storegade 1",
"postal_code": "9530",
"city": "Støvring",
"phone": "+4598765432",
"email": "kontakt@example.dk",
"currency": "DKK",
"timezone": "Europe/Copenhagen",
"points_per_100kr": 5,
"point_value_minor": 100,
"order_types": [
"pickup",
"delivery"
],
"opening_hours": [
{
"day_of_week": 0,
"opens": "11:00",
"closes": "21:00",
"closed": false
},
{
"day_of_week": 6,
"opens": null,
"closes": null,
"closed": true
}
]
}
}Endpoint
Slå en kundes point op
/loyalty/balanceKræver loyalty:readSaldoen er præcis den, kunden ser i jeres webshop og app — også point optjent i butikken. Ét point er én krone. Ukendt kunde giver 404.
| Felt | Hvor | Type | Beskrivelse |
|---|---|---|---|
| company_idpåkrævet | query | uuid | Virksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang. |
| phone | query | string | Kundens telefonnummer. Formatet er ligegyldigt — +45 12 34 56 78 og 12345678 er samme kunde. |
| query | string | Kundens e-mail. | |
| customer_id | query | uuid | Kundens id, hvis I har det fra en ordre. Angiv én af de tre. |
curl -s "https://api.walletplus.dk/api/pos/v1/loyalty/balance?company_id=3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d&phone=%2B4512345678" \
-H "Authorization: Bearer $WALLETPLUS_KEY"{
"data": {
"customer_id": "c41a7e20-6b3d-4f8a-a1c9-0d2e3f4a5b6c",
"company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
"member": true,
"balance": 170,
"total_earned": 220,
"total_spent": 50,
"point_value_minor": 100,
"movements": [
{
"id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"type": "earn",
"amount": 12,
"balance_after": 170,
"description": "Optjent i butikken (bon bon-90210)",
"order_id": null,
"reference": "bon-90210",
"created_at": "2026-09-24T15:42:12.000Z"
}
]
}
}Endpoint
Indløs point
/loyalty/redeemKræver loyalty:writeTræk point fra kundens saldo ved kassen. Har kunden for få point, svarer vi 409 med det faktiske antal — vi trækker aldrig mindre i stilhed.
Kunden skal være medlem af kundeklubben — ellers svarer vi 409 conflict. Samme reference trækker aldrig to gange, heller ikke med en ny Idempotency-Key; I får already_applied: true tilbage.
| Felt | Hvor | Type | Beskrivelse |
|---|---|---|---|
| company_idpåkrævet | body | uuid | Virksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang. |
| phone | body | string | Kundens telefonnummer. Formatet er ligegyldigt — +45 12 34 56 78 og 12345678 er samme kunde. |
| body | string | Kundens e-mail. | |
| customer_id | body | uuid | Kundens id, hvis I har det fra en ordre. Angiv én af de tre. |
| pointspåkrævet | body | heltal | Antal point der skal trækkes. 1 point = 1 kr. |
| referencepåkrævet | body | string | Jeres egen reference for indløsningen. Samme reference trækker aldrig to gange. |
| description | body | string | Vises i kundens historik. |
| Idempotency-Keypåkrævet | header | string | Unik pr. handling. Genbrug den ved et genforsøg af præcis samme kald. |
curl -s -X POST "https://api.walletplus.dk/api/pos/v1/loyalty/redeem" \
-H "Authorization: Bearer $WALLETPLUS_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
"phone": "+4512345678",
"points": 50,
"reference": "bon-90210-point"
}'{
"data": {
"customer_id": "c41a7e20-6b3d-4f8a-a1c9-0d2e3f4a5b6c",
"points_spent": 50,
"discount_minor": 5000,
"balance": 120,
"already_applied": false
}
}Endpoint
Meld et butikssalg ind
/salesKræver sales:writeGør at kunden også optjener point, når de handler i butikken. Kunden er valgfri: uden kunde gemmes salget og giver 0 point. Vi opretter ingen ordre og rører ingen penge.
- Kunden er valgfri. Viste kunden ikke sit kort, så send salget alligevel uden
phone/email— det gemmes og giver 0 point. - Kun medlemmer af kundeklubben optjener, med samme sats som online.
external_ider jeres bon-id. Samme bon to gange giver den første registrering tilbage medalready_recorded: true— aldrig point to gange.occurred_ater hvornår salget skete i butikken, ikke hvornår I sender det.- Højst 100.000 kr pr. bon. Point gives højst for 25.000 kr køb pr. kunde pr. døgn; salget gemmes altid, og svaret siger
points_capped: true, når loftet gav færre point.
| Felt | Hvor | Type | Beskrivelse |
|---|---|---|---|
| company_idpåkrævet | body | uuid | Virksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang. |
| external_idpåkrævet | body | string | Jeres bon-id. Samme bon to gange giver den første registrering tilbage — aldrig point to gange. |
| gross_amount_minorpåkrævet | body | heltal (øre) | Bonens bruttobeløb i øre. 245,00 kr er 24500. Højst 100.000 kr pr. bon. |
| occurred_atpåkrævet | body | ISO 8601 | Hvornår salget skete i butikken, med tidszone. En kasse der har været offline må melde bagud. |
| phone | body | string | Kundens telefonnummer. Formatet er ligegyldigt — +45 12 34 56 78 og 12345678 er samme kunde. |
| body | string | Kundens e-mail. | |
| customer_id | body | uuid | Kundens id, hvis I har det fra en ordre. Angiv én af de tre. |
| Idempotency-Keypåkrævet | header | string | Unik pr. handling. Genbrug den ved et genforsøg af præcis samme kald. |
curl -s -X POST "https://api.walletplus.dk/api/pos/v1/sales" \
-H "Authorization: Bearer $WALLETPLUS_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
"external_id": "bon-90210",
"gross_amount_minor": 24500,
"occurred_at": "2026-09-24T17:42:11+02:00",
"phone": "+4512345678"
}'{
"data": {
"id": "f0e1d2c3-b4a5-4968-8776-655443322110",
"company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
"external_id": "bon-90210",
"customer_id": "c41a7e20-6b3d-4f8a-a1c9-0d2e3f4a5b6c",
"gross_amount_minor": 24500,
"currency": "DKK",
"points_earned": 12,
"occurred_at": "2026-09-24T15:42:11.000Z",
"created_at": "2026-09-24T15:42:12.000Z"
},
"already_recorded": false,
"points_capped": false
}