开放文档API

curl -X POST 'https://your-api-host.com/pay/payChannel/queryCorpHasPayChannel' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "corpId": 10001
}'
									

{
  "code": "200", // 注意：JSON 定义是 "200"，但示例是 "0"，以 JSON 定义为准
  "msg": "成功",
  "data": true // true 表示已配置，false 表示未配置
}
									

{
  "code": "404", // 示例：企业不存在
  "msg": "企业信息未找到",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/pay/payChannel/queryChannelList' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "flowId": 1234567890,
  "source": "pc"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": [ // 支付渠道基本信息列表
    {
      "id": 1, // 支付渠道ID
      "corpId": 10001, // 企业ID (商户主体)
      "providerCode": "alipay", // 支付服务商代码
      "providerName": "支付宝",
      "payTypeCode": "SCAN_CODE", // 支付方式代码 (例如扫码支付)
      "appId": "alipay_app_id_for_pc" // 支付渠道关联的支付AppID
    },
    {
      "id": 3,
      "corpId": 10001,
      "providerCode": "wxpay",
      "providerName": "微信支付",
      "payTypeCode": "NATIVE", // Native 支付 (类似扫码)
      "appId": "wxpay_appid_for_pc"
    }
    // ... 其他可用渠道
  ]
}
									

{
  "code": "404", // 示例：流程不存在
  "msg": "流程信息未找到",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/pay/payOrder/add' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: PAYER_USER_ID' \
-d '{
  "channelId": 1, // 选择上面查询到的支付宝扫码支付渠道
  "signerId": 8002, // 假设关联到合同参与方 8002
  "returnUrl": "https://your-website.com/payment/success",
  "source": "pc"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 支付链接基本信息
    "id": 9001, // 新创建的支付单ID
    "orderCode": "PAY20240110123456789", // 支付单号
    "payTypeCode": "SCAN_CODE", // 支付类型代码
    "merchantAccount": "seller_alipay_account@example.com",
    "merchantType": 2, // 商户类型
    "businessOrderNo": "CONTRACT12345_PAY", // 关联的业务单号
    "status": 0, // 0: 订单生成 (待支付)
    "goodsType": 1, // 1: 单合同签
    "goodsName": "合同签署服务费",
    "amount": 10.00, // 支付金额
    "payUrl": "https://qr.alipay.com/..." // 支付链接 (扫码支付时是二维码内容, H5是跳转链接, JSAPI时可能是调起支付的JSON参数)
  }
}
									

{
  "code": "1101", // 示例：业务错误
  "msg": "支付金额计算错误或未找到关联业务",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/pay/payOrder/listByPage' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "status": 2,
  "beginTime": "2024-01-01 00:00:00",
  "endTime": "2024-01-10 23:59:59",
  "listPageNo": 1,
  "listPageSize": 10
}'
									

{
  "code": "200",
  "msg": "成功",
  // 注意：JSON定义未明确分页结构，以下为推测结构
  "listPageNo": 1,
  "countInPage": 1,
  "listPageCount": 1,
  "totalCount": 1,
  "data": [ // 支付单基本信息列表 (结构见下方支付单查询接口)
    {
      "id": 9001,
      "orderCode": "PAY20240110123456789",
      "businessOrderNo": "CONTRACT12345_PAY",
      "amount": 10.00,
      "status": 2, // 2:支付成功
      "goodsName": "合同签署服务费",
      "goodsType": 1,
      "payTypeCode": "SCAN_CODE",
      "providerCode": "alipay",
      "psnId": 20002,
      "psnName": "李四",
      "corpId": 10001,
      "corpName": "示例科技有限公司",
      "orderType": 1,
      "createTime": "2024-01-10T11:00:00.000+0800",
      "successTime": "2024-01-10T11:05:00.000+0800"
      // ... 其他字段
    }
    // ...更多支付单
  ]
}
									

注意： 响应体中分页信息的具体结构 (listPageNo, countInPage, listPageCount, totalCount) 未在 OpenAPI 定义中明确，以上字段仅为常见示例。

{
  "code": "500", // 示例：查询失败
  "msg": "查询支付单列表时发生错误",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/pay/payOrder/query' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "id": 9001
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 支付单基本信息
    "id": 9001,
    "orderCode": "PAY20240110123456789",
    "businessOrderNo": "CONTRACT12345_PAY",
    "amount": 10.00,
    "status": 2, // 2:支付成功
    "goodsName": "合同签署服务费",
    "goodsType": 1,
    "goodsBody": "为合同 CONTRACT12345 支付签署服务费",
    "channelModelId": 1, // 关联的通道方式ID
    "payTypeCode": "SCAN_CODE",
    "providerCode": "alipay",
    "psnId": 20002,
    "psnName": "李四",
    "corpId": 10001,
    "corpName": "示例科技有限公司",
    "orderType": 1, // 1:企业(发起或支付主体)
    "createTime": "2024-01-10T11:00:00.000+0800",
    "successTime": "2024-01-10T11:05:00.000+0800",
    "expiredTime": "2024-01-10T12:00:00.000+0800",
    "refundAmount": 0.00,
    "refundTimes": 0,
    "remark": "用户扫码支付成功"
    // "extendInfo": {} // 扩展信息可能在此处返回
  }
}
									

{
  "code": "404", // 示例：支付单不存在
  "msg": "支付单未找到",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/pay/payOrder/cancel' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "id": 9002 // 假设要取消支付单 9002
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": {} // 通常成功取消不返回具体数据
}
									

{
  "code": "1102", // 示例：状态不允许
  "msg": "支付单状态不是待支付，无法取消",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/pay/payChannel/getPayOpenId' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: USER_ID_TO_GET_OPENID' \
-d '{
  "channelModelId": 2, // 假设 2 是微信 JSAPI 渠道
  "authCode": "code_from_wechat_oauth",
  "source": "wx" // 假设来自微信小程序
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": "wxopenid_for_target_user" // 返回的 openId
}
									

{
  "code": "400", // 示例：授权码无效
  "msg": "无效的授权码或已过期",
  "data": null
}