Skip to content

快速接入

1. 准备接入信息

  • 商户号 mchNo
  • 应用号 appId
  • 商户私钥(请求签名)
  • 平台公钥(响应验签)
  • 网关地址(如 https://your-domain

2. 请求公共参数

所有 @PaymentVerify 对外接口均需携带:

  • mchNo 商户号
  • appId 应用号(不传时按后端默认应用策略)
  • reqTime 请求时间(yyyy-MM-dd HH:mm:ss
  • nonceStr 随机串(建议每次唯一)
  • sign 签名
  • clientIp 客户端IP(可选)

3. 调用流程

  1. 组装业务参数
  2. 按签名规则生成 sign
  3. 发送 JSON 请求到 /unipay/*
  4. 验证响应 sign
  5. code 判断业务结果

4. Bruno 调试

  1. 打开 Bruno -> Collections -> Import Collection -> OpenAPI
  2. 导入 /openapi/unipay.yaml
  3. 配置环境变量:baseUrl/mchNo/appId/privateKey/publicKey
  4. 调试接口并查看请求签名与响应验签结果

下一步:阅读 API 中心