订单查询 - 外部订单号

通过该接口查询订单处理状态

接口说明

下单接口提交后可通过该接口查询订单状态
建议优先对接回调通知数据返回

接口地址

/openapi/queryByCustomerOrderNo

请求参数

参数名称	字段类型	是否必填	最大长度	示例值（加密前）	描述
app_key	string	是	32	64a6285f23c5a	应用app Key
customer_order_no	string	是	64	1689736728	外部订单号，请确保订单号唯一
timestamp	int	是	12	1689736728	请求时间戳
sign	string	是	32	参见样例	签名，参见签名规则

请求数据样例

json

{
	"app_key": "64b9eb7c20b89",
	"customer_order_no": "1689906148",
	"timestamp": 1689907061,
	"sign": "8a29bfab3f950052a8851acc80767da3"
}

返回参数说明

参数名称	字段类型	是否必填	最大长度	示例值（加密前）	描述
order_no	string	是	32	18642666082271232	平台订单号
customer_order_no	string	是	64	1689736728	外部订单号，请确保订单号唯一
card_no	string	否	32	9070247051131562875	卡号
card_secret	string	是	32	123456	卡密
cookie_type	int	是	4	1	CK类型：1PC、2M站、3api
card_face	int	否	4	50	卡面值
card_balance	int	是	8	50	卡余额
card_end_date	string	是	32	2026-07-17	过期时间
status	string	是	32	success	订单状态（success：成功，processing：处理中，failed：失败，cancel：已取消）
error_code	string	否	32	90001	仅失败情况下需要根据该字段进行处理，参见错误码定义
error_msg	string	否	255	卡密错误	过期时间

订单处理成功结果返回

json

{
	"code": 0,
	"data": {
		"order_no": "18642666082271232",
		"customer_order_no": "1689908817",
		"cookie_type": 1,
		"product_code": "JDE",
		"card_no": "JDV11540037803000087",
		"card_secret": "FC4465CF370E0ED9",
		"card_face": 50,
		"card_balance": "50.00",
		"card_end_date": "2026-07-17",
		"created_at": "2023-07-21 11:06:56",
		"finished_at": "2023-07-21 11:07:41",
		"error_code": "",
		"error_msg": "",
		"status": "success"
	},
	"message": "查询成功"
}

订单处理失败结果返回

json

{
	"code": 0,
	"data": {
		"order_no": "18631473976311808",
		"customer_order_no": "1689906148",
		"cookie_type": 1,
		"product_code": "JDE",
		"card_no": "",
		"card_secret": "3792859B221BCC1F",
		"card_face": "",
		"card_balance": "",
		"card_end_date": "",
		"created_at": "2023-07-21 10:22:28",
		"finished_at": "2023-07-21 10:22:58",
		"error_code": "90001",
		"error_msg": "卡密错误",
		"status": "failed"
	},
	"message": "查询成功"
}

订单查询 - 外部订单号 ​

接口说明 ​

接口地址 ​

请求参数 ​

返回参数说明 ​

订单查询 - 外部订单号

接口说明

接口地址

请求参数

返回参数说明