Zum Inhalt springen
meniodeveloper
menio DashboardVorschau

POST tokens/{id}/ExternalBasket?pin={pin} · Web API v3 · Deutsch

API-ReferenzWeb API v3 · Deutschtokens

POST tokens/{id}/ExternalBasket?pin={pin}

Web API v3 · Deutsch v3tokens
Aktualität laut Confluence unklar. Die englische POS API v3 ist die aktuelle Referenz.
POST/tokens/{id}/ExternalBasket?pin={pin}

Hiermit können sie einen Basket einreichen ohne dabei die internen Prozesse auszulösen.

Bitte bilden Sie zum '{id}_{balanceToAdd}' (z.B. 'card123_1.99') eine Checksumme (siehe Security-Token) und geben Sie diese im SecurityToken-Header an.

Parameter

idstringErforderlich

Geben Sie hier den von einem Trägermedium ausgelesenen Token an.

Beispiel: 'cardId123'
pinstring

Die optionale PIN, im Fall dass die Ressource GET tokens/{id}/info das Feld RequiresPin auf true gesetzt hat. Die PIN ist üblicherweise auf der Karte gedruckt.

Beispiel: 'PQ123'

Request-Header

DevKey
{Ihr Key}
TrackingUnitId
{trackingUnitId}
SecurityToken
{checksumme über '{id}_{balanceToWithdraw}'} (in diesem Beispiel über 'card123_1.99')
Token
optional {der von einem Trägermedium ausgelesene Token als Kunden-Identifier}
Kontext: tokens

Tokens sind beliebig geartete, jedoch stets voneinander unterschiedliche, nicht wiederholbare Strings, welche sowohl zur Identifikation eines Konsumenten ( consumer ) als auch zur Identifikation eines Guthabens ( balance ) verwendet werden können. In der Regel werden diese Tokens auf einem beliebigen Trägermedium gespeichert und an einen Konsumenten in Form einer Kundenkarte oder Geschenkkarte ausgehändigt. Der Konsument wird bei seinen nächsten Käufen dieses Trägermedium am POS vorzeigen müssen, um auf das darin gespeicherte Guthaben zugreifen zu können bzw. die menio-Rewards angerechnet zu bekommen.

Originaler Blueprint-Ausschnitt
API Blueprint
### POST tokens/{id}/ExternalBasket?pin={pin} [POST]
Hiermit können sie einen Basket einreichen ohne dabei die internen Prozesse auszulösen.

*Bitte bilden Sie zum* **'{id}_{balanceToAdd}'** *(z.B. 'card123_1.99') eine Checksumme (siehe [Security-Token](#introduction/grundlegendes/secutiry-token)) und geben Sie diese im `SecurityToken`-Header an.*

+ Parameters
    + id (string, `'cardId123'`) ... Geben Sie hier den von einem Trägermedium ausgelesenen Token an. 
    + pin (optional, string, `'PQ123'`) ... Die optionale PIN, im Fall dass die Ressource GET tokens/{id}/info das Feld `RequiresPin` auf `true` gesetzt hat. Die PIN ist üblicherweise auf der Karte gedruckt.

+ Request

    + Headers

            DevKey: {Ihr Key}
            TrackingUnitId: {trackingUnitId}
            SecurityToken: {checksumme über '{id}_{balanceToWithdraw}'} (in diesem Beispiel über 'card123_1.99')
            Token: optional {der von einem Trägermedium ausgelesene Token als Kunden-Identifier}
            
    + Body
    
                {
                    "BillNumber": "727e085b-91e9-4383-92b6-b53e04ea1615",
                    "TimestampUtc": "2024-02-16T08:51:01.216Z",
                    "Positions": [
                        {
                            "PositionId": 0,
                            "ProductId": "QNP-1699877891354",
                            "Amount": 1,
                            "Name": "Hamburger",
                            "OrderTimeUtc": "2024-02-16T08:51:01.216Z",
                            "ProductProps": {}
                        }
                    ]
                }

+ response 200