鸿途Pay 开放接口文档

接口基础地址以商户后台实际网关地址为准，下文以 https://你的商户域名/ 表示

欢迎接入鸿途Pay。本文档面向已开通商户的技术对接人员，涵盖签名规则、页面跳转支付、统一下单、订单查询、支付结果通知、关闭订单、支付方式列表等支付相关接口的说明。

签名规则

签名步骤

对本平台接口发起的请求，需要进行签名。

1、获取请求报文所有非空请求参数，不包括数组、字节类型参数，如文件、字节流，剔除 sign、sign_type 字段，并按照第一个字符的键值 ASCII 码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值 ASCII 码递增排序，以此类推。

2、将排序后的参数和对应值，组合成“参数=参数值”的格式，并且把这些参数用 & 字符连接起来，此时生成的字符串为待签名字符串。

3、使用商户私钥，对待签名字符串计算 RSA 签名（SHA256WithRSA），得到签名 sign。

验签步骤

针对接口返回的数据，以及异步通知回调的数据，需进行验签。

1、先根据签名步骤里面的 1～2，获取到待签名字符串。

2、使用平台公钥，根据签名字符串 sign，对待签名字符串进行 RSA 验签（SHA256WithRSA）。

注意事项

1、商户私钥（private key）需填写到代码中供签名时使用。生成的私钥需妥善保管，避免遗失，不要泄露。

2、平台公钥（public key）用于接口返回数据、异步通知回调数据的验签。

3、具体发起支付相关流程的示例代码可下载 SDK 查看。

MD5 兼容签名（旧商户）

未升级 RSA 密钥的商户，可继续使用 MD5 签名方式。

1、按签名步骤 1～2 生成待签名字符串（剔除 sign、sign_type 及空值参数，按键名 ASCII 升序，以 & 连接成 a=1&b=2 形式，末尾不带 &）。

2、将商户密钥（商户后台 API 信息中的商户密钥）直接拼接在待签名字符串末尾，做 MD5 计算并转小写：

sign = md5(待签名字符串 + 商户密钥)

3、请求时 sign_type 传 MD5（或不传）。建议新对接商户统一使用 RSA 签名。

页面跳转支付

此接口可用于用户前台直接发起支付，使用 form 表单跳转或拼接成 url 跳转。

请求地址：

https://你的商户域名/api/pay/submit

请求方式：

POST 或 GET（推荐 POST，不容易被劫持）

请求参数说明：

其他说明：

• 支付方式（type）不传会跳转到收银台支付。

统一下单接口

此接口可用于服务器后端发起支付请求，会返回支付二维码链接、支付跳转url等。

请求地址：

https://你的商户域名/api/pay/create

请求方式：

POST

请求参数说明：

返回参数说明：

返回示例：

{
    "code": 0,
    "trade_no": "20160806151343349",
    "pay_type": "qrcode",
    "pay_info": "weixin://wxpay/bizpayurl?pr=04IPMKM"
}

{
    "code": 0,
    "trade_no": "20160806151343351",
    "pay_type": "jsapi",
    "pay_info": "{\"appId\":\"wx2421b1c4370ec43b\",\"timeStamp\":\"1395712654\",\"nonceStr\":\"e61463f8efa94090b1f366cccfbbb444\",\"package\":\"prepay_id=up_wx21201855730335ac86f8c43d1889123400\",\"signType\":\"RSA\",\"paySign\":\"oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvkYD7rthRAZ\"}"
}

{
    "code": 0,
    "trade_no": "2024072320222180092",
    "pay_type": "scan",
    "pay_info": "{\"type\":\"wxpay\",\"trade_no\":\"2024072320222180092\",\"api_trade_no\":\"4200002345202407238253501450\",\"buyer\":\"o9uAcc6VlZxhcujpKIqQuWWoDQc\",\"money\":\"1.00\"}"
}

{
    "code": 0,
    "trade_no": "2024072320222180018",
    "pay_type": "wxplugin",
    "pay_info": "{\"appId\":\"wxc237fd59fbb634ae\",\"supplierId\":\"123456\",\"shopId\":\"123456\",\"orderId\":\"2024072320222180092\"}"
}

{
    "code": 0,
    "trade_no": "2024072320222180018",
    "pay_type": "wxapp",
    "pay_info": "{\"appId\":\"wxbb48bac536053072\",\"miniProgramId\":\"gh_bf9cd8cf50b5\",\"path\":\"pages/fromAppPay/index?orderid=123456\",\"extraData\":\"\"}"
}

接口类型列表

设备类型列表

发起支付类型说明

其他说明：

• 代码中需根据接口返回的 pay_type 值来展示具体的支付页面，例如扫码页面等。如果不懂怎么展示支付页面，可在 method 传入 jump，这样 pay_type 就只会返回 jump，直接跳转支付即可。
• 付款码支付可不传支付类型 type 字段，会根据 auth_code 的数字自动判断支付类型。
• 微信小程序插件支付，不同支付平台拉起支付方式不一样，可联系客服获取对接小程序插件的文档。
• APP拉起微信小程序可参考微信官方文档：Launching a Mini-Program。

订单查询

请求地址：

https://你的商户域名/api/pay/query

请求方式：

POST

请求参数说明：

返回参数说明：

支付状态列表

支付结果通知

通知类型：

服务器异步通知（notify_url）、页面跳转通知（return_url）

请求方式：

GET

请求参数说明：

返回内容说明：

收到异步通知后，需返回 success 以表示服务器接收到了订单通知。

其他说明：

• 商户系统代码内务必对返回的签名 sign 进行校验，并且判断 trade_status 的值是否等于 TRADE_SUCCESS。
• 支付平台可能会增加回调字段，验证签名时必须支持增加的扩展字段。

订单关闭

请求地址：

https://你的商户域名/api/pay/close

请求方式：

POST

请求参数说明：

返回参数说明：

其他说明：

• 只有部分支付插件支持关闭订单操作。

支付方式列表

下单接口中 type 字段的调用值，由平台按商户已开通的支付通道动态提供，实际可用取值以商户后台展示为准。

注：上表为文档示例中出现的常用取值；平台内置更多支付通道，具体可传值以商户后台「支付方式 / 对接信息」页面为准。