Open API Reference for Bluepay

# 1.1 提交工单

# URL

  • {domain}/open-api/bluepay/abnormalTransIssue/addIssueFromOpen

# 请求方式

  • POST

# 请求头

参数名 必选 类型 说明
Content-Type 是 string application/json

# 请求体参数

参数名 必选 类型 长度限制 示例 说明
appId 是 string - - 应用APPID
param 是 string - - 参数体
sign 是 string - 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 签名

# param 参数

参数名 是否必填 类型 说明
requestId 是 string 请求流水号
mchOrderId 是 string 商户订单号，字母+数字，最大长度32
amount 是 integer 金额，多单COD总金额，单位：分
ticketType 是 integer 工单类型， 1.交易状态异常
payerType 是 integer 付款人身份，1.骑手 2.收件人 3.其他付款人
courierMobile 是 string 快递员电话，手机格式：06,08,09+8位数字（共10位）座机格式：02,03,04,05,07+7位数字（共9位）
payerMobile 是 string 当付款人非骑手时，必填，付款人为骑手时，无需填写 ，格式同courierMobile
transactionDate 是 string 交易日期， yyyy-MM-dd (例如：2023-10-01)
notifyUrl 是 string 工单处理结果通知URL
problemDescription 是 string 问题描述，最多500字符
proofImage 是 List(string) 证明图片，最多五张

# 响应参数

参数名 类型 说明
requestId string 请求流水号
ticketNo string 工单号

# 请求示例

# param 内容

{
  "requestId": "wwtestce20252902",
  "mchOrderId": "wwwwentestmchOrderId2705",
  "amount": 100000,
  "ticketType": 1,
  "payerType": 2,
  "courierMobile": "0611111111",
  "payerMobile": "0611111112",
  "transactionDate": "2025-10-29",
  "notifyUrl": "https://webhook.site/2eadaa58-8d72-43b6-baa5-fd9206b55627",
  "problemDescription": "problemDescription",
  "proofImage": [
    "bluepay/onboard/extern/22fe507ee71d04cee1665b9879164724.jpg",
    "bluepay/onboard/extern/ec6a0b833f7def2bf05664f7c2ca491b.jpeg",
    "bluepay/onboard/extern/c40354a007efc7db10cc6a69e4ab00ba.jpeg",
    "bluepay/onboard/extern/b34acd761cf197176d89995e556e58d7.png",
    "bluepay/onboard/extern/71336c315e0ca0909c614583a7efaf52.pdf"
  ]
}

# 请求体

{
  "sign": "45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892",
  "appId": "3d717fb236534ef0a63f7c44c25260c6",
  "param": "{\"requestId\":\"wwtestce20252902\",\"mchOrderId\":\"wwwwentestmchOrderId2705\",\"amount\":100000,\"ticketType\":1,\"payerType\":2,\"courierMobile\":\"0611111111\",\"payerMobile\":\"0611111112\",\"transactionDate\":\"2025-10-29\",\"notifyUrl\":\"https://webhook.site/2eadaa58-8d72-43b6-baa5-fd9206b55627\",\"problemDescription\":\"problemDescription\",\"proofImage\":[\"bluepay/onboard/extern/22fe507ee71d04cee1665b9879164724.jpg\",\"bluepay/onboard/extern/ec6a0b833f7def2bf05664f7c2ca491b.jpeg\",\"bluepay/onboard/extern/c40354a007efc7db10cc6a69e4ab00ba.jpeg\",\"bluepay/onboard/extern/b34acd761cf197176d89995e556e58d7.png\",\"bluepay/onboard/extern/71336c315e0ca0909c614583a7efaf52.pdf\"]}"
}

# 响应示例

{
  "code": 10000,
  "message": "Success",
  "data": {
    "requestId": "testce2025300932",
    "ticketNo": "202511031059144551"
  }
}

← 1.2 处理结果查询 →