WorldFirst DocsWorldFirst Docs

createTradeOrder需要签名验签

POST /amsin/api/v1/business/worldtrade/createTradeOrder

集成商可调用此接口创建WorldTrade贸易订单。

报文结构

万里汇接口的报文结构包括:请求头、请求体、响应头和响应体。该章节主要介绍请求体和响应体的结构。关于请求头和响应头的更多信息,参见:

入参

requestId String  REQUIRED

针对本次创建订单请求,由集成商指定的唯一请求号。

更多信息:

  • 最大长度:64 字符

totalAmount Amount  REQUIRED

订单总金额。

更多信息:

  • 值范围: 0 - 1000000000 USD
Show child parameters

orderProductType String  REQUIRED

订单类型。可取值范围:

  • PRODUCT_INFO :产品类型

productList Array<Product>  REQUIRED

产品信息。

Show child parameters

sellerInfo Participant  REQUIRED

卖家信息。

Show child parameters

buyerInfo Participant  REQUIRED

买家信息。

Show child parameters

paymentTerm PaymentTerm  REQUIRED

交易条款信息。

Show child parameters

shippingTerm ShippingTerm  REQUIRED

物流条款信息。

Show child parameters

payResultNotifyUrl String  REQUIRED

支付结果通知地址。

orderResultNotifyUrl String  REQUIRED

订单扫描拒绝通知地址。

deliveryResultNotifyUrl String  REQUIRED

发货审核结果通知地址。

memo String  

附言。

该字段不支持以下特殊字符:​:​ 和 ​/

出参

result Result  REQUIRED

代表接口调用结果。

Show child parameters

tradeId String  REQUIRED

WorldTrade系统生成的订单ID。

此字段只有当 result.resultStatus = S 时才会按需返回。

更多信息:

  • 最大长度:64 字符

WolrdTrade返回给买家的订单链接信息。

此字段只有当 result.resultStatus = S 时才会按需返回。

WolrdTrade返回给买家的订单支付链接信息。

此字段只有当 result.resultStatus = S 时才会按需返回。

API Explorer

请求

URL
请求体

响应

响应体

响应处理

集成商调用接口后,万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为:

result.resultStatus

描述

S

API请求成功。

F

API请求失败。

失败原因参见结果码(即 result.resultCode 和 result.resultMessage 

U

API响应结果为UNKNOWN(未知)时,需重试API请求。

重试策略:

  • 重试次数上限:7次
  • 重试时间间隔:5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟

如果问题依旧,请联系万里汇技术支持。

result.resultCode:系统结果码

结果码结果码信息行动建议
SUCCESSSSuccess
PROCESS_FAILFA general business failure occurred. Do Not retry.

需要人工介入,联系万里汇技术支持以解决此问题

PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

确认请求正确加签

INVALID_SIGNATUREFThe signature is invalid.

确认请求正确加签

REPEAT_REQ_INCONSISTENTFRepeated requests are inconsistent.

重试请求不一致,需保证所有请求参数均相同

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题

FILE_SIZE_EXCEED_LIMITFThe file size has exceeded the limit.

文件大小需在允许范围内

CONTRACT_CHECK_FAILFThe contract check has failed.

检查合约状态后重试

result.resultCode:业务结果码

结果码结果码信息行动建议
PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

请检查参数后重试

SYSTEM_EXCEPTIONFSystem exception.

需要人工介入,联系WorldTrade客户服务经理以解决此问题

USER_INFO_ERRORFThe user information is incorrect.

确认买家及卖家相关信息无误后重试

WRONG_DELIVERY_ORIGINFThe delivery origin value is incorrect.

确认shippingTerm.deliveryOrigin 参数传值正确后重试

ORDER_REJECTEDFThe order is rejected due to security concerns.

需要人工介入,联系WorldTrade客户服务经理以解决此问题

AMOUNT_ERRORFIncorrect order amount.

请修改订单相关金额后重试

EMAIL_ERRORFThe seller's email and buyer's email cannot be identical.

使用不同的买家及卖家邮箱后重试

UNSUPPORTED_BUYER_EMAILFThe buyer's email is not supported.

需要人工介入,联系WorldTrade客户服务经理以解决此问题

REPEATED_REQUESTFRepeated request.

幂等请求,无需重试

FILE_NOT_EXISTFThe file does not exist.

使用正确的文件信息后重试

DELIVERY_COUNTRY_ERRORFThe country of shipment is wrong.

修改发货相关参数后重试

SELLER_COUNTRY_ERRORFThe seller's country is wrong

确认sellerInfo.companyAddress.countryCode 参数传值正确后重试