API 文档

# 3、查询订单

  • 查询订单状态

# 查询收款订单

请求方式 POST

请求 URL/api/v3/mex/bankTransfers/query/collectingOrder

请求类型:

"Content-Type": "application/json; charset=utf-8"

请求头参数

Param Type Description Sample
access_key String 商户后台获取 pFqV75X3
timestamp String 13 位 Unix 毫秒时间戳 1679724896223
nonce String UUID v4 随机字符串 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String 用 secret_key 加签结果 kAXyh+eerqrefyaF8dyFB0M4FVo=

请求示例

{
  "externalOrderId": "389508808434869257",
  "orderId": "OCURRPAID202307270301551690426915467DOCKER020000000400000744"
}

请求参数说明

Param Type Required Description
externalOrderId String 选填 商户订单号
orderId String 选填 系统订单号

响应类型

Header: { "Content-Type": "application/json; charset=utf-8" }

响应示例

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": [{
		"orderId": "OCURRPAID202307140712051689318725535DOCKER020000000400000168",
		"cashierId": "OCURRPAID202307140712051689318725469DOCKER020000000200000167",
		"orderType": 1,
		"orderResourceType": 2,
		"userId": "1663371399710216194",
		"orderStatus": 1,
		"orderTime": 1689318726000,
		"channelOrderId": "20230714071207439140854557",
		"externalOrderId": "354997490558818072",
		"orderAmount": "40.2",
		"orderActualAmount": null,
		"orderFee": null,
		"orderPayTime": null,
		"orderCompleteTime": null,
		"currencyType": "MXN",
		"payType": 102,
		"tradeNote": "123",
		"notifyUrl": "http://192.168.1.135:30001/",
		"markStatus": 0,
		"errorMsg": "",
		"errorMsgEn": "",
		"accountType": "",
		"accountName": "",
		"accountNo": "",
		"orderTypeCode": "Pay",
		"orderResourceTypeCode": "Currency",
		"orderStatusCode": "Accepted",
		"payTypeCode": "BANK",
        "userInfoName":"",
      	"userInfoNo":"",
      	"businessId":"1749105475963odyplcnk09geo1668pq"
	}]
}

响应参数说明

参数名 类型 描述
orderId String 订单ID
cashierId String 收银台ID
orderType int64 订单类型
orderResourceType int64 订单所属业务类型
userId String 用户ID
orderStatus int64 订单状态 1-待支付
2- 支付成功
orderTime int64 订单发起时间
channelOrderId String 订单关联渠道订单ID
externalOrderId String 商户订单号
orderAmount String 订单金额
orderActualAmount String 订单实际金额
orderFee int64 订单手续费
orderPayTime int64 订单支付时间
currencyType String 货币类型
payType int64 支付类型
tradeNote String 备注
notifyUrl String 回调URL
markStatus int64 标记状态
errorMsg String 错误信息
errorMsgEn String 错误信息英文
accountType String 账户类型
accountName String 账户名称
accountNo String 账户号
orderTypeCode String 订单类型code
orderResourceTypeCode String 订单所属业务类型code
orderStatusCode String orderStatusc描述
payTypeCode String 支付类型code参考payType
userInfoNo String 用户证件号
userInfoName String 用户姓名
businessId String 商户企业标识 ID

# 查询代付订单

请求方式 POST

请求 URL /api/v3/mex/query/transferOrder

请求类型:

"Content-Type": "application/json; charset=utf-8"

请求头参数

Param Type Desc Sample
access_key String 商户后台获取 pFqV75X3
timestamp int64 Unix 时间戳 13 位 1679724896223
nonce String UUID V4 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String 计算出的签名 kAXyh+eerqrefyaF8dyFB0M4FVo=

请求示例

{
  "externalOrderId": "241534072867503522",
  "orderId": "OCARDDEP0202306090256051686279365706DOCKER020000000200001399"
}

请求参数说明

Param Type Require Desc
externalOrderId String 选填 商户订单号
orderId String 选填 系统订单号

响应类型

Header: { 'Content-Type': 'application/json;charset=utf-8'}

响应示例

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": [{
		"orderId": "OCURRDRAW202307170821151689582075477DOCKER020000000200000233",
		"cashierId": "",
		"orderType": 2,
		"orderResourceType": 2,
		"userId": "1663371399710216194",
		"orderStatus": 1,
		"orderTime": 1689582076000,
		"channelOrderId": "",
		"externalOrderId": "979744221460536657",
		"orderAmount": "40.2",
		"orderActualAmount": "41",
		"orderFee": "0.8",
		"orderPayTime": null,
		"currencyType": "MXN",
		"payType": 202,
		"tradeNote": "123",
		"notifyUrl": "http://192.168.1.135:30001",
		"markStatus": 0,
		"errorMsg": "",
		"errorMsgEn": "",
		"accountType": "40",
		"accountName": "AZTECA2",
		"accountNo": "13178968534",
		"orderTypeCode": "Transfer",
		"orderResourceTypeCode": "Currency",
		"orderStatusCode": "Accepted",
		"payTypeCode": "BANK"
	}]
}

响应参数说明

orderId String 订单ID
cashierId String 收银台ID
orderType int64 订单类型
orderResourceType int64 订单所属业务类型
userId String 用户ID
orderStatus int64 订单状态：1-已受理；2-银行处理中；4-失败(银行未受理)；8-成功；16-失败
orderTime int64 订单发起时间
channelOrderId String 订单关联渠道订单ID
externalOrderId String 商户订单号
orderAmount String 订单金额
orderActualAmount String 订单实际金额
orderFee int64 订单手续费
orderPayTime int64 订单支付时间
currencyType String 货币类型
payType int64 支付类型
tradeNote String 备注
notifyUrl String 回调URL
markStatus int64 标记状态
errorMsg String 错误信息
errorMsgEn String 错误信息（英文）
accountType String 账户类型
accountName String 账户名称
accountNo String 账户号
orderTypeCode String 订单类型code
orderResourceTypeCode String 订单所属业务类型code
orderStatusCode String orderStatus描述
payTypeCode String 支付类型code，参考payType

← 4、查询余额 →