快速开始

本页用于帮助研发在最短时间内跑通亿付通支付网关的基本链路。

接入前准备

项目	说明
mchNo	商户号，由平台分配
appId	应用 ID，用于区分不同业务应用
apiKey / privateKey	签名密钥或私钥，按实际签名算法配置
gatewayHost	网关地址，示例中统一使用 https://{gateway-host} 占位
notifyUrl	异步通知地址，需公网可访问
returnUrl	同步跳转地址，可选

公共请求字段

大多数接口都会携带以下基础字段：

字段	是否必填	说明
mchNo	是	商户号
appId	是	应用 ID
version	是	固定建议 1.0
reqTime	是	请求时间，通常使用 13 位时间戳
signType	是	签名算法，例如 MD5 或 RSA2
sign	是	按签名规则生成

接入流程

1. 先完成下单接口联调，确认请求签名和返回验签逻辑正确。
2. 根据 payDataType 处理支付参数，发起二维码、跳转链接、表单或 App 调起。
3. 业务系统实现异步通知接口，只在验签和业务处理都完成后返回 success。
4. 支付完成后按需接入退款、转账和分账能力。

统一下单示例

curl -X POST "https://{gateway-host}/api/pay/unifiedOrder" \
  -H "Content-Type: application/json" \
  -d '{
    "mchNo": "M202604230001",
    "appId": "APP202604230001",
    "mchOrderNo": "ORD202604230001",
    "wayCode": "WX_NATIVE",
    "amount": 100,
    "currency": "CNY",
    "subject": "会员充值",
    "body": "亿付通支付测试订单",
    "notifyUrl": "https://merchant.example.com/pay/notify",
    "returnUrl": "https://merchant.example.com/pay/result",
    "clientIp": "127.0.0.1",
    "version": "1.0",
    "reqTime": 1713849600000,
    "signType": "MD5",
    "sign": "YOUR_SIGN"
  }'

常见返回结构

{
  "code": 0,
  "msg": "SUCCESS",
  "sign": "RESPONSE_SIGN",
  "data": {
    "payOrderId": "P202604230001",
    "mchOrderNo": "ORD202604230001",
    "orderState": 1,
    "payDataType": "codeUrl",
    "payData": "weixin://wxpay/bizpayurl?pr=xxxx"
  }
}

上线检查清单

• 下单、查单、关单接口都完成签名与验签。
• 通知地址支持幂等处理，重复通知不重复入账。
• 前端或业务系统能正确识别 payDataType。
• 退款、转账、分账接口均已在测试环境完成回归。
• 生产环境证书、白名单、域名备案和回调监控已准备完成。