Release Notes

2025-09-24 06:18

Release date: September 24, 2025

Modified

API name

Impacts

createTradeOrder

Request body

Added warning note for the following parameters:

productList

Updated the value range of the following parameter:

shippingTerm.shippingRelativeDays

queryTradeOrder

Response body

Added warning note for the following parameters:

productList

Updated the value range of the following parameter:

shippingTerm.shippingRelativeDays

Release date: September 16, 2025

Modified

API name	Impacts
createTradeOrder	Request body Updated the description of the following parameters: buyerInfo.companyName productList.productDetail productList.productName productList.specificationDetail sellerInfo.companyAddress.countryCode sellerInfo.companyAddress.city sellerInfo.companyAddress.province
queryTradeOrder	Response body Updated the description of the following parameters: buyerInfo.companyName productList.productDetail productList.productName productList.specificationDetail sellerInfo.companyAddress.countryCode sellerInfo.companyAddress.city sellerInfo.companyAddress.province
Enumerations	Added List of cities for field value input: sellerInfo.companyAddress.city Added List of provinces for field value input: sellerInfo.companyAddress.province

Release date: August 27, 2025

Modified

API name

Impacts

createTradeOrder

Request body

Added the following parameter:

productList.imageFile.fileUrl

Updated the description of the following parameter:

productList.imageFile.fileKey
productList.imageFile.fileName

Integration guide

Updated the note in Develop and integrate > Step 1.

Release date: August 21, 2025

Modified

API name	Impacts
uploadAttachment	Response body Added the below business-related result code: `PERMISSION_NOT_GRANTED`
createTradeOrder	Response body Added the below business-related result code: `PERMISSION_NOT_GRANTED`
createDelivery	Response body Added the below business-related result code: `PERMISSION_NOT_GRANTED`
applyRefund	Response body Added the below business-related result code: `PERMISSION_NOT_GRANTED`

Release date: June 27, 2025

Modified

API name

Impacts

createTradeOrder

Request body

Added the following parameter:

shippingTerm.deliveryDestination.city

Updated the code samples

queryTradeOrder

Response body:

Added the following parameter:

shippingTerm.deliveryDestination.city

Updated the code samples

Release date: May 27, 2025

Added

Added the applyRefund API.

Release date: May 23, 2025

Modified

API name	Impacts
API Overview	Updated the sample request URL at the testing environment.
createTradeOrder	Request body Added the following parameters: paymentTerm.discountType paymentTerm.discountAmount paymentTerm.discountRate shippingTerm.logisticsInsuranceFee shippingTerm.logisticsInspectionFee shippingTerm.shippingFee Updated the description of the following parameter: totalAmount
queryTradeOrder	Response body Added the following parameters: paymentTerm.discountType paymentTerm.discountAmount paymentTerm.discountRate shippingTerm.logisticsInsuranceFee shippingTerm.logisticsInspectionFee shippingTerm.shippingFee

Release date: Apr 27, 2025

To further enhance customer experience, WorldTrade allows merchants to create trade orders in euros. See the following for the API updates.

Modified

API name	Impacts
createTradeOrder	Request body: Updated the description of the following parameters totalAmount productList.specification.unitAmount productList.specification.totalAmount
queryTradeOrder	Response body: Updated the description of the following parameters orderBasicInfo.totalAmount productList.specification.unitAmount productList.specification.totalAmount deliveryBatchList.deliveryVoucher.logisticsVoucherType
createDelivery	Request body: Updated the description of the following parameters logisticsVoucherType

Release date: Apr 17, 2025

Added the Integration guide.

Release date: Mar 24, 2025

The first version of this documentation is released, including the following APIs: