Spring til indholdet

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/v1

Kræver en nøgle, der starter med wp_live_.

Endpoint

Hent ordrer

GET/ordersKræver orders:read

Ordrerne 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. 1

    Første kald

    Sæt updated_since til det tidspunkt, I vil have historik fra.
  2. 2

    Gem next_cursor

    Læg den i jeres egen database — ikke kun i hukommelsen.
  3. 3

    Alle senere kald

    Send cursor, og drop updated_since helt.
  4. 4

    Er has_more true?

    Så kald igen med det samme — I er bagud.

Den fejl der koster ordrer

Byg aldrig et nyt 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.
FeltHvorTypeBeskrivelse
company_idpåkrævetqueryuuidVirksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang.
updated_sincequeryISO 8601Første kald: ordrer ændret siden dette tidspunkt. Udelades, når I sender cursor.
cursorquerystringnext_cursor fra forrige svar. Gem den i jeres egen database.
statusquerylisteKommasepareret, fx confirmed,ready. Udeladt betyder alle.
limitquery1–200Antal 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"
Svar · 200
{
  "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

GET/orders/{orderId}Kræver orders:read

Én ordre med alle linjer. Bruges typisk efter en webhook, som kun bærer ordrens id og status.

FeltHvorTypeBeskrivelse
orderIdpåkrævetstiuuidOrdrens id.
company_idpåkrævetqueryuuidVirksomhedens 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"
Svar · 200
{
  "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 menukortet

GET/menuKræver menu:read

Hele menukortet som ét snapshot: kategori → produkt → variant → tilvalgsgruppe → tilvalg. Inaktive retter og undergrupper (tilvalgsgrupper under et bestemt valg) er ikke med. Send svarets ETag tilbage som If-None-Match, og få 304 uden body, når intet er ændret.

FeltHvorTypeBeskrivelse
company_idpåkrævetqueryuuidVirksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang.
If-None-MatchheaderstringETag fra sidste svar. Uændret kort giver 304 Not Modified.
curl -s "https://api.walletplus.dk/api/pos/v1/menu?company_id=3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d" \
  -H "Authorization: Bearer $WALLETPLUS_KEY"
Svar · 200
{
  "company_id": "3d6f0b52-8a1e-4c7d-9b20-5e4f1a2c3b4d",
  "currency": "DKK",
  "etag": "\"3f9a1c7e\"",
  "categories": [
    {
      "id": "9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a",
      "name": "Pizza",
      "description": null,
      "sort_order": 1,
      "parent_category_id": null,
      "products": [
        {
          "id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
          "sku": "12",
          "name": "Margherita",
          "description": "Tomat, mozzarella og basilikum",
          "base_price_minor": 7500,
          "image_url": null,
          "sold_out": false,
          "is_alcohol": false,
          "dine_in_only": false,
          "sort_order": 1,
          "variants": [
            {
              "id": "6b7c8d9e-0f1a-4b2c-9d3e-4f5a6b7c8d9e",
              "name": "Stor",
              "price_minor": 7975,
              "sold_out": false,
              "option_groups": [
                {
                  "id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
                  "name": "Ekstra",
                  "required": false,
                  "selection_type": "multiple",
                  "free_quantity": 0,
                  "options": [
                    {
                      "id": "8d9e0f1a-2b3c-4d4e-9f5a-6b7c8d9e0f1a",
                      "name": "Ekstra ost",
                      "price_minor": 1000
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Endpoint

Hent virksomheden

GET/companyKræver company:read

Stamdata, ordretyper, pointsats og åbningstider. Ugedagene tælles fra 0 = mandag til 6 = søndag.

FeltHvorTypeBeskrivelse
company_idpåkrævetqueryuuidVirksomhedens 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"
Svar · 200
{
  "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

GET/loyalty/balanceKræver loyalty:read

Saldoen 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.

FeltHvorTypeBeskrivelse
company_idpåkrævetqueryuuidVirksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang.
phonequerystringKundens telefonnummer. Formatet er ligegyldigt — +45 12 34 56 78 og 12345678 er samme kunde.
emailquerystringKundens e-mail.
customer_idqueryuuidKundens 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"
Svar · 200
{
  "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

POST/loyalty/redeemKræver loyalty:write

Træ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.

FeltHvorTypeBeskrivelse
company_idpåkrævetbodyuuidVirksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang.
phonebodystringKundens telefonnummer. Formatet er ligegyldigt — +45 12 34 56 78 og 12345678 er samme kunde.
emailbodystringKundens e-mail.
customer_idbodyuuidKundens id, hvis I har det fra en ordre. Angiv én af de tre.
pointspåkrævetbodyheltalAntal point der skal trækkes. 1 point = 1 kr.
referencepåkrævetbodystringJeres egen reference for indløsningen. Samme reference trækker aldrig to gange.
descriptionbodystringVises i kundens historik.
Idempotency-KeypåkrævetheaderstringUnik 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"
}'
Svar · 201
{
  "data": {
    "customer_id": "c41a7e20-6b3d-4f8a-a1c9-0d2e3f4a5b6c",
    "points_spent": 50,
    "discount_minor": 5000,
    "balance": 120,
    "already_applied": false
  }
}

Endpoint

Meld et butikssalg ind

POST/salesKræver sales:write

Gø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_id er jeres bon-id. Samme bon to gange giver den første registrering tilbage med already_recorded: true — aldrig point to gange.
  • occurred_at er 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.
FeltHvorTypeBeskrivelse
company_idpåkrævetbodyuuidVirksomhedens id. Hvert kald gælder én virksomhed, og den skal have givet jer adgang.
external_idpåkrævetbodystringJeres bon-id. Samme bon to gange giver den første registrering tilbage — aldrig point to gange.
gross_amount_minorpåkrævetbodyheltal (øre)Bonens bruttobeløb i øre. 245,00 kr er 24500. Højst 100.000 kr pr. bon.
occurred_atpåkrævetbodyISO 8601Hvornår salget skete i butikken, med tidszone. En kasse der har været offline må melde bagud.
phonebodystringKundens telefonnummer. Formatet er ligegyldigt — +45 12 34 56 78 og 12345678 er samme kunde.
emailbodystringKundens e-mail.
customer_idbodyuuidKundens id, hvis I har det fra en ordre. Angiv én af de tre.
Idempotency-KeypåkrævetheaderstringUnik 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"
}'
Svar · 201
{
  "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
}