Question 1

'updateMerchantOrderId' 端点的用途是什么？

Accepted Answer

此 API 端点用于使用您商店的订单 ID 更新 Zonos 系统中的订单，以便更好地进行协调、沟通和审计。

Question 2

'updateMerchantOrderId' 请求的必需参数是什么？

Accepted Answer

必需的参数是 'merchantOrderId'、'orderId'、'secret' 和 'store'。

Question 3

'updateMerchantOrderId' 成功响应是什么样的？

Accepted Answer

成功响应将包含一条消息，指示订单更新，例如：'Updated Order: 99999 with new merchantOrderId: 12-34567'。

Question 4

'updateMerchantOrderId' 错误响应是什么样的？

Accepted Answer

错误响应将包含一个 'error' 参数及其原因的描述，例如：'Could not retrieve order to updateMerchantOrderId for orderId: 99999'。

Question 5

'updateMerchantOrderId' 请求的可能错误 HTTP 响应有哪些？

Accepted Answer

可能的错误 HTTP 响应包括 406 - Not Acceptable、415 - Unsupported media type 和各种包含不同错误消息的 200 响应。

字段↕	说明↕
HTTP 方法	POST
端点 URL	`https://api.iglobalstores.com/v1/updateMerchantOrderId`
协议	HTTPS
消息格式	JSON
Accept HTTP 标头	Accept: application/json
Content-Type HTTP 标头	Content-Type: application/json

字段↕	说明↕
`merchantOrderId` 必需	此参数用于将您商店的内部订单 ID 传递到 Zonos 系统中的订单。建议用于更好地协调、沟通和审计。`string`
`orderId` 必需	Zonos 订单 ID - 可以通过或不通过您的商店 ID 和连字符传递（例如：123-45678 或 45678）。注意：订单完成并支付后，客户将被重定向到托管在您的域上的订单完成/订单感谢页面。URL 将包含一个查询字符串参数"orderId"，其中包含此值。`integer / string`
`secret` 必需	Zonos 提供的 API 密钥 GUID。`string`
`store` 必需	Zonos 提供的商店 ID`integer`

错误代码↕	定义↕
406 - Not Acceptable	HTML 实体。HTTP"Accept"标头无效。
415 - Unsupported media type	HTML 实体。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"

消息↕	定义↕
`error`	当发生错误时，此参数将仅出现在响应中，并将包含错误原因的描述。`string`
`success`	此参数将包含更新摘要。`string`

更新订单号

端点