DOCS

Oppdater ordrenummer

Lær hvordan endepunktet for oppdatering av ordrenummer fungerer.

Endepunktet updateMerchantOrderId brukes til å oppdatere en ordre i Zonos-systemet med butikkens ordre-ID for bedre avstemming, kommunikasjon og revisjon.

Endepunkt 

POST | https://api.iglobalstores.com/v1/updateMerchantOrderId

HTTPS-forespørsel

Felt↕Notater↕
HTTP-metodePOST
Endepunkt-URLhttps://api.iglobalstores.com/v1/updateMerchantOrderId
ProtokollHTTPS
MeldingsformatJSON
Accept HTTP-hodeAccept: application/json
Content-Type HTTP-hodeContent-Type: application/json

JSON-nøkler/-verdier i forespørselsteksten

1{
2 "store": "999",
3 "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
4 "orderId": "999-9999",
5 "merchantOrderId": "12-34567"
6}

Definisjoner av JSON i forespørsel

Felt↕Notater↕
merchantOrderId PÅKREVDDenne parameteren brukes til å sende butikkens interne ordre-ID til ordren i Zonos-systemet. Dette anbefales for bedre avstemming, kommunikasjon og revisjon.string
orderId PÅKREVDZonos ordre-ID - kan sendes med eller uten butikk-ID og bindestrek (Eksempel: 123-45678 eller 45678).Merk: Etter ordregjennomføring og betaling blir kunden omdirigert til en Order Completion / Order Thank You-side som ligger på ditt domene. URL-en vil inneholde en querystring-parameter "orderId" som vil inneholde denne verdien.integer / string
secret PÅKREVDAPI-hemmelighet GUID levert av Zonos.string
store PÅKREVDButikk-ID levert av Zonosinteger

HTTPS-svar

1{
2 "success": "Updated Order: 99999 with new merchantOrderId: 12-34567"
3}

Feilsvar for HTTP

Feilkode↕Definisjon↕
406 - Not AcceptableHTML Entity. HTTP "Accept"-hode er ugyldig.
415 - Unsupported media typeHTML Entity. HTTP "Content-Type"-hode er ugyldig.
200"error":"could not parse input"
200"error":"Parameter orderId is required to processUpdateMerchantOrderId"
200"error":"Parameter merchantOrderId is required to updateMerchantOrderId."
200"error":"orderId: 999-99999 is not a valid orderId"
200"error":"Could not retrieve order to updateMerchantOrderId for orderId: 999-99999"
200"error":"Could not process update merchant order id."
200"error":"Invalid security credentials"

Definisjoner av JSON i svar

Melding↕Definisjon↕
errorDenne parameteren vil bare være til stede i svaret når en feil har oppstått og vil inneholde en beskrivelse av årsaken.string
successDenne parameteren vil inneholde et sammendrag av oppdateringen.string
Bestill en demo

Var denne siden nyttig?