Endepunkt
POST | https://api.iglobalstores.com/v1/updateMerchantOrderId
HTTPS forespørsel
| Felt | Notater |
|---|---|
| HTTP-metode | POST |
| Endepunkt-URL | https://api.iglobalstores.com/v1/updateMerchantOrderId |
| Protokoll | HTTPS |
| Meldingsformat | JSON |
| Aksepter HTTP-header | Accept: application/json |
| Content-Type HTTP-header | Content-Type: application/json |
JSON nøkkel/verdi-par i forespørselens kropp
Eksempel
1
2
3
4
5
6
{
"store": "999",
"secret": "f5bde245-f55e-414d-b722-80b25161c12c",
"orderId": "999-9999",
"merchantOrderId": "12-34567"
}
Forespørsel JSON-definisjoner
| Felt | Notater |
|---|---|
merchantOrderId PÅKREVET | Denne parameteren brukes til å sende butikkens interne bestillings-ID til bestillingen i Zonos-systemet. Dette anbefales for bedre avstemming, kommunikasjon og revisjon.string |
orderId PÅKREVET | Bestillings-ID for Zonos - kan sendes med eller uten butikkens ID og bindestrek (Eksempel: 123-45678 eller 45678).Merk: Etter fullføring av bestillingen og betaling, vil kunden bli omdirigert til en side for fullføring av bestilling / Takk for bestillingen som er vert på ditt domene. URL-en vil inneholde en spørringsparameter “orderId” som vil inneholde denne verdien.integer / string |
secret PÅKREVET | API-hemmelig GUID gitt av Zonos.string |
store PÅKREVET | Butikk-ID gitt av Zonosinteger |
HTTPS-respons
Eksempel på vellykket respons
1
2
3
{
"success": "Updated Order: 99999 with new merchantOrderId: 12-34567"
}
Eksempel på feilmelding
1
2
3
{
"error": "Could not retrieve order to updateMerchantOrderId for orderId: 99999"
}
HTTP-feilrespons
| Feilkode | Definisjon |
|---|---|
| 406 - Ikke akseptabel | HTML-enhet. HTTP "Accept"-headeren er ugyldig. |
| 415 - Ugyldig mediatype | HTML-enhet. HTTP "Content-Type"-headeren er ugyldig. |
| 200 | “error”:”kunne ikke analysere inngang” |
| 200 | “error”:”Parameter orderId er nødvendig for å prosessereUpdateMerchantOrderId” |
| 200 | “error”:”Parameter merchantOrderId er nødvendig for å updateMerchantOrderId.” |
| 200 | “error”:”orderId: 999-99999 er ikke en gyldig orderId” |
| 200 | “error”:”Kunne ikke hente ordre for updateMerchantOrderId for orderId: 999-99999” |
| 200 | “error”:”Kunne ikke prosessere oppdatering av handelsordre-id.” |
| 200 | “error”:”Ugyldige sikkerhetslegitimasjoner” |
Respons JSON-definisjoner
| Melding | Definisjon |
|---|---|
error | Denne parameteren vil kun være til stede i responsen når en feil har oppstått og vil inneholde en beskrivelse av årsaken.string |
success | Denne parameteren vil inneholde et sammendrag av oppdateringen.string |
Oppdater bestillingsnummer
Lær hvordan endepunktet for å oppdatere et bestillingsnummer fungerer.
Den
updateMerchantOrderIdendepunktet brukes til å oppdatere en bestilling i Zonos-systemet med din butiks bestillings-ID for bedre avstemming, kommunikasjon og revisjon.