Hent en bestilling

Dette “Hent en bestilling” API-endepunktet brukes til å hente data for en fullført bestilling inne i Zonos-systemet. Responsen vil inneholde et JSON-objekt som representerer all tilgjengelig informasjon for bestillingen, inkludert fakturerings- og leveringsadresser, fraktmetode, bestillingssummer og status.

Endepunkter 

Bestillingsnumre

Henter en liste over bestillingsnumre.

Bestillingsdetaljer

Henter detaljert informasjon for en bestilling.

Bruk av API-endepunktet for å hente en bestilling

Det er to vanlige måter å bruke disse endepunktene på.

1. (Del 1 + Del 2) – Bruk en tilpasset bestillingsbekreftelse / suksessside på ditt domene for å utløse systemet ditt til å kalle orderDetail-endepunktet og importere en fullført bestilling. I tillegg, kall regelmessig orderNumbers-endepunktet for å avstemme eventuelle bestillinger i Zonos-systemet som ikke er importert til systemet ditt.
2. (Del 2 Kun) – Bruk Zonos sin grunnleggende bestillingsbekreftelse / suksessside eller en statisk side på ditt domene for å indikere bestillingsfullføring til kunden. Planlegg systemet ditt til regelmessig å kalle orderNumbers-endepunktet for å bestemme når en ny bestilling er klar til å bli importert i systemet ditt. Når en utestående bestilling er funnet, kall orderDetail-endepunktet for data om disse bestillingene.

Del 1: Suksessside på ditt domene

Hver gang en kjøper fullfører en bestilling i Zonos Checkout, blir de umiddelbart omdirigert til en bestillings suksessside-URL. Den fullførte bestillings-ID-en vil bli lagt til omdirigerings-URL-en som en spørringsstreng. URL-en til bestillings suksesssiden bør gis til Zonos. URL-en kan også sendes som en parameter i createTempCart-endepunktet når den midlertidige handlekurven opprettes i Zonos-systemet.

Eksempel: http://www.examplestore.com/internationalThankYou?orderId=999-99999

Når en kunde blir omdirigert til denne siden, må systemet ditt analysere verdien for orderId fra URL-en. Du vil deretter bruke orderId til å kalle orderDetail-endepunktet for å hente bestillingsdataene.

Del 2: Bruk en planlagt jobb

I tillegg til å kalle for bestillingsdetaljer når suksesssiden utløses, anbefaler vi at du setter opp en planlagt samtale for alle bestillinger og deres detaljer som en fangst. På denne måten kan du hente eventuelle fullførte bestillinger i Zonos-systemet som ennå ikke er importert til systemet ditt.

Denne prosessen bør være en planlagt jobb/script, som en Cron-jobb, kjørt en gang i timen/skift/dag/etc. (planlegg så ofte som forretningsprosessene dine anser som nødvendig). Skriptet bør kalle for alle bestillinger og deres detaljer som har skjedd siden den siste samtalen for bestillinger. orderNumbers-endepunktet lar deg hente bestillinger sinceOrderId eller sinceDate som demonstrert på API-test-GUI-en som ligger her. Alle bestillingene som hentes gjennom denne planlagte samtalen bør deretter avstemmes mot bestillingene som ble satt inn i systemet ditt hver gang suksesssiden ble utløst. Eventuelle bestillinger som ikke allerede er i systemet ditt bør settes inn i systemet ditt og behandles som legitime bestillinger.

Innledende bestillingsstatus

IGLOBAL_ORDER_IN_PROCESS eller IGLOBAL_FRAUD_REVIEW

Når du kaller orderDetail-endepunktet, anbefaler vi at systemet ditt først sjekker orderStatus-egenskapen til bestillingsdataene.

Bestillinger som ikke krever svindelvurdering vil initialiseres med orderStatus : IGLOBAL_ORDER_IN_PROCESS. En bestilling i denne statusen er klar til å bli behandlet og sendt.

Bestillinger som krever svindelvurdering vil initialiseres i orderStatus : IGLOBAL_FRAUD_REVIEW. En bestilling i denne statusen blir for øyeblikket screenet og vurdert for mistenkt svindel. Vi anbefaler at du plasserer denne bestillingen i en vurderings- eller holdstatus i systemet ditt og fortsetter å kalle orderDetail-endepunktet til bestillingen går videre fra Zonos’ svindelvurderingsprosess.

Når Zonos svindelscreeningsprosess er fullført, vil bestillingen flytte til en av følgende tilstander:

• Bestilling passerer svindelscreening

  • Bestillingen vil flytte til orderStatus : IGLOBAL_ORDER_IN_PROCESS og kan fortsette mot forsendelse.

• Bestilling feiler svindelscreening

  • Bestillingen vil flytte til orderStatus : IGLOBAL_ORDER_CANCELLED og bør avbestilles i systemet ditt.

API-test GUI

Vennligst kontakt support for dine kontoopplysninger.