주문 검색

이 “주문 검색” API 엔드포인트는 Zonos 시스템 내에서 완료된 주문에 대한 데이터를 검색하는 데 사용됩니다. 응답에는 청구 및 배송 주소, 배송 방법, 주문 총액 및 상태를 포함하여 주문에 대한 모든 사용 가능한 정보를 나타내는 JSON 객체가 포함됩니다.

엔드포인트 

주문 번호

주문 번호 목록을 검색합니다.

주문 세부정보

주문에 대한 자세한 정보를 검색합니다.

주문 검색 API 엔드포인트 사용법

이러한 엔드포인트를 사용하는 두 가지 일반적인 방법이 있습니다.

1. (파트 1 + 파트 2) – 도메인에서 사용자 정의 주문 확인/성공 페이지를 사용하여 시스템이 orderDetail 엔드포인트를 호출하고 완료된 주문을 가져오도록 트리거합니다. 또한, 정기적으로 orderNumbers 엔드포인트를 호출하여 Zonos 시스템에 가져오지 않은 주문을 조정합니다.
2. (파트 2만) – Zonos 기본 주문 확인/성공 페이지 또는 도메인에서 정적 페이지를 사용하여 고객에게 주문 완료를 표시합니다. 시스템이 정기적으로 orderNumbers 엔드포인트를 호출하여 새 주문이 시스템에 가져올 준비가 되었는지 확인하도록 예약합니다. 미결 주문이 발견되면 해당 주문에 대한 데이터를 가져오기 위해 orderDetail 엔드포인트를 호출합니다.

파트 1: 도메인에서의 성공 페이지

구매자가 Zonos Checkout에서 주문을 완료할 때마다 즉시 주문 성공 페이지 URL로 리디렉션됩니다. 완료된 주문 ID는 쿼리 문자열로 리디렉션 URL에 추가됩니다. 주문 성공 페이지의 URL은 Zonos에 제공되어야 합니다. 이 URL은 Zonos 시스템에서 임시 장바구니를 생성할 때 createTempCart 엔드포인트의 매개변수로 전달될 수도 있습니다.

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

고객이 이 페이지로 리디렉션되면, 시스템은 URL에서 orderId 값을 파싱해야 합니다. 그런 다음 orderId를 사용하여 orderDetail 엔드포인트를 호출하여 주문 데이터를 검색합니다.

파트 2: 예약 작업 사용

성공 페이지가 트리거될 때 주문 세부정보를 호출하는 것 외에도, 모든 주문 및 세부정보에 대한 예약 호출을 설정하는 것이 좋습니다. 이렇게 하면 Zonos 시스템에서 아직 시스템에 가져오지 않은 모든 완료된 주문을 검색할 수 있습니다.

이 프로세스는 Cron 작업과 같은 예약 작업/스크립트로 설정되어야 하며, 매 시간/교대/일/etc. (비즈니스 프로세스에 따라 필요에 따라 자주 예약). 스크립트는 마지막 주문 호출 이후 발생한 모든 주문 및 세부정보를 호출해야 합니다. orderNumbers 엔드포인트를 사용하면 sinceOrderId 또는 sinceDate로 주문을 검색할 수 있으며, API 테스트 GUI에서 이를 확인할 수 있습니다. 이 예약 호출을 통해 검색된 모든 주문은 성공 페이지가 트리거될 때마다 시스템에 삽입된 주문과 조정되어야 합니다. 시스템에 이미 없는 주문은 시스템에 삽입되어 정당한 주문으로 처리되어야 합니다.

초기 주문 상태

IGLOBAL_ORDER_IN_PROCESS 또는 IGLOBAL_FRAUD_REVIEW

orderDetail 엔드포인트를 호출할 때, 시스템이 먼저 주문 데이터의 orderStatus 속성을 확인하는 것이 좋습니다.

사기 검토가 필요하지 않은 주문은 orderStatus : IGLOBAL_ORDER_IN_PROCESS로 초기화됩니다. 이 상태의 주문은 처리 및 배송 준비가 완료된 상태입니다.

사기 검토가 필요한 주문은 orderStatus : IGLOBAL_FRAUD_REVIEW로 초기화됩니다. 이 상태의 주문은 현재 의심되는 사기에 대해 심사 및 검토 중입니다. 이 주문은 시스템에서 검토 또는 보류 상태로 두고, 주문이 Zonos의 사기 검토 프로세스를 통과할 때까지 orderDetail 엔드포인트를 계속 호출하는 것이 좋습니다.

Zonos의 사기 심사 프로세스가 완료되면, 주문은 다음 상태 중 하나로 이동합니다:

• 주문이 사기 심사를 통과함

  • 주문은 orderStatus : IGLOBAL_ORDER_IN_PROCESS로 이동하며 배송을 계속할 수 있습니다.

• 주문이 사기 심사를 통과하지 못함

  • 주문은 orderStatus : IGLOBAL_ORDER_CANCELLED로 이동하며 시스템에서 취소되어야 합니다.

API 테스트 GUI

계정 자격 증명에 대해서는 지원팀에 문의하시기 바랍니다.