订单接口

基础信息

• 传输协议：HTTPS
• 数据格式：Content-Type: application/json
• 认证方式：请求体携带 mer_no 与 api_key
• 接口 API URL：联系平台获取

创建订单

创建订单并获取支付链接。

请求

POST <API_URL>（联系平台获取）

请求头

参数名	必填	示例值	说明
Content-Type	是	application/json	请求体类型

请求体（JSON）

参数名	类型	必填	说明
amount	string	是	金额（单位元）
mer_no	string	是	商户号
trade_no	string	是	商户侧订单号（全局唯一）
notify_url	string	是	异步通知地址（平台 -> 商户）
return_url	string	是	同步跳转地址
remark	string	否	备注信息
api_key	string	是	商户密钥
channel_id	string	是	渠道标识（联系平台获取）

示例请求（JSON）

{
  "amount": "100.00",
  "mer_no": "1751266106011309940263252",
  "trade_no": "external_order_123456722292222",
  "notify_url": "https://example.com/notify",
  "return_url": "https://example.com/return",
  "remark": "测试订单",
  "api_key": "******",
  "channel_id": "888"
}

响应

成功响应示例

{
  "code": 200,
  "status": "success",
  "message": "订单创建成功",
  "data": {
    "order_no": "SY20250630171835855368",
    "trade_no": "external_order_1234567222922",
    "merchant_no": "1751266106011309940263252",
    "amount": "100.00",
    "remark": "测试订单",
    "pay_url": "<BASE_URL>/view/card_sub_static/card_sub?trade_no=external_order_1234567222922",
    "status": 2,
    "verify_status": 4
  }
}

错误响应示例

{
  "code": 409,
  "status": "error",
  "message": "订单号 trade_no 已存在"
}

幂等与重试建议

• trade_no 应保持唯一；重复请求可能返回 409，也可能返回同一笔订单的信息（以平台实际实现为准）
• 商户侧如遇网络超时等不确定结果，允许使用相同 trade_no 进行重试，并以「查询订单」结果为准

查询订单

按 mer_no + trade_no 查询订单状态。

请求

POST <API_URL>（联系平台获取）

请求体（JSON）

参数名	类型	必填	说明
mer_no	string	是	商户号
trade_no	string	是	商户侧订单号
api_key	string	是	商户密钥

示例请求（JSON）

{
  "mer_no": "1751266106011309940263252",
  "trade_no": "external_order_1234567",
  "api_key": "******"
}

响应

{
  "code": 200,
  "status": "success",
  "message": "查询成功",
  "data": {
    "order_no": "SY20250630153837123456",
    "trade_no": "external_order_1234567",
    "amount": "100.00",
    "status": 2,
    "verify_status": 4,
    "card_code": "KAMI-1234-5678-9012",
    "created_at": "2025-06-30 15:38:37",
    "card_submit_at": "",
    "processed_at": ""
  }
}

字段如 card_submit_at、processed_at 无值时返回空字符串 ""，不返回 null。