DOCS

주문 번호 업데이트

주문 번호를 업데이트하는 엔드포인트의 작동 방식을 알아보세요.

updateMerchantOrderId 엔드포인트는 더 나은 조정, 커뮤니케이션, 감사를 위해 Zonos 시스템의 주문을 스토어 주문 ID로 업데이트하는 데 사용됩니다.

엔드포인트 

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

HTTPS 요청

필드↕참고↕
HTTP 메서드POST
엔드포인트 URLhttps://api.iglobalstores.com/v1/updateMerchantOrderId
프로토콜HTTPS
메시지 형식JSON
Accept HTTP 헤더Accept: application/json
Content-Type HTTP 헤더Content-Type: application/json

요청 본문의 JSON 키/값 쌍

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

요청 JSON 정의

필드↕참고↕
merchantOrderId REQUIRED이 매개변수는 스토어의 내부 주문 ID를 Zonos 시스템의 주문에 전달하는 데 사용됩니다. 더 나은 조정, 커뮤니케이션, 감사를 위해 사용하는 것이 권장됩니다.string
orderId REQUIREDZonos 주문 ID로, 스토어 ID와 하이픈을 포함하거나 포함하지 않고 전달할 수 있습니다(예: 123-45678 또는 45678). 참고: 주문 완료 및 결제 후 고객은 귀사의 도메인에서 호스팅되는 주문 완료 페이지(주문 감사 페이지)로 리디렉션됩니다. URL에는 이 값을 포함하는 쿼리스트링 매개변수 “orderId”가 포함됩니다.integer / string
secret REQUIREDZonos에서 제공하는 API 시크릿 GUID입니다.string
store REQUIREDZonos에서 제공하는 스토어 ID입니다integer

HTTPS 응답

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

오류 HTTP 응답

오류 코드↕정의↕
406 - Not AcceptableHTML 엔티티. HTTP “Accept” 헤더가 유효하지 않습니다.
415 - Unsupported media typeHTML 엔티티. HTTP “Content-Type” 헤더가 유효하지 않습니다.
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”

응답 JSON 정의

메시지↕정의↕
error이 매개변수는 오류가 발생했을 때만 응답에 포함되며, 원인에 대한 설명을 포함합니다.string
success이 매개변수는 업데이트에 대한 요약을 포함합니다.string

이 페이지가 도움이 되었나요?