Slutpunkt
POST | https://api.iglobalstores.com/v1/updateMerchantOrderId
HTTPS-anmodning
| Felt↕ | Noter↕ |
|---|---|
| HTTP-metode | POST |
| Endpoint URL | https://api.iglobalstores.com/v1/updateMerchantOrderId |
| Protokol | HTTPS |
| Meddelelsesformat | JSON |
| Accept HTTP-header | Accept: application/json |
| Content-Type HTTP-header | Content-Type: application/json |
JSON-nøgle/værdi-par i anmodningens brødtekst
1
{2
"store": "999",3
"secret": "f5bde245-f55e-414d-b722-80b25161c12c",4
"orderId": "999-9999",5
"merchantOrderId": "12-34567"6
}Anmodning JSON definitioner
| Felt↕ | Noter↕ |
|---|---|
merchantOrderId PÅKRÆVET | Denne parameter bruges til at videregive din butiks interne ordre-id til ordren i Zonos-systemet. Dette anbefales for bedre afstemning, kommunikation og revision.string |
orderId PÅKRÆVET | Zonos-ordre-id'et - kan videregives med eller uden dit butiks-id og bindestreg (eksempel: 123-45678 eller 45678). Bemærk: Efter ordreafslutning og betaling vil kunden blive omdirigeret til en ordregennemførelse/ordretak-side, der er hostet på dit domæne. URL'en vil indeholde en forespørgselsstrengparameter "orderId", der vil indeholde denne værdi.integer / string |
secret PÅKRÆVET | API hemmelig GUID leveret af Zonos.string |
store PÅKRÆVET | Butiks-id leveret af Zonosinteger |
HTTPS-svar
1
{2
"success": "Updated Order: 99999 with new merchantOrderId: 12-34567"3
}Fejl i HTTP-svar
| Fejlkode↕ | Definition↕ |
|---|---|
| 406 - Ikke acceptabelt | HTML-enhed. HTTP "Accept" header er ugyldig. |
| 415 - Ikke-understøttet medietype | HTML-enhed. HTTP "Content-Type" header er ugyldig. |
| 200 | "error":"kunne ikke parse input" |
| 200 | "error":"Parameter orderId er påkrævet for at behandleUpdateMerchantOrderId" |
| 200 | "error":"Parameter merchantOrderId er påkrævet for at opdatereMerchantOrderId." |
| 200 | "error":"orderId: 999-99999 er ikke et gyldigt orderId" |
| 200 | "error":"Kunne ikke hente ordre til at opdatereMerchantOrderId for orderId: 999-99999" |
| 200 | "error":"Kunne ikke behandle opdatering af sælgerordre-id." |
| 200 | "error":"Ugyldige sikkerhedsoplysninger" |
Svar JSON definitioner
| Besked↕ | Definition↕ |
|---|---|
error | Denne parameter vil kun være til stede i svaret, når der er opstået en fejl, og vil indeholde en beskrivelse af årsagen.string |
success | Denne parameter vil indeholde en oversigt over opdateringen.string |
Opdater ordrenummer
Lær, hvordan slutpunktet til at opdatere et ordrenummer fungerer.
updateMerchantOrderId-slutpunktet bruges til at opdatere en ordre i Zonos-systemet med din butiks ordre-id for bedre afstemning, kommunikation og revision.