请求参数
- 请求参数格式约定如下：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 接口名称 | method | 是 | S(64) | unified_order | 对应接口的名称 |
| 字符集 | charset | 是 | S(16) | UTF-8 | 字符集编码，固定值UTF-8 |
| 接口版本号 | version | 是 | S(8) | 1.0 | 对应接口的版本号，固定值1.0 |
| 格式化类型 | format | 是 | S(8) | json | 各个接口业务参数的格式化类型，固定值json |
| 时间戳 | timestamp | 是 | T | 20210315155012 | 时间戳与宝付支付系统时间误差不超过10分钟，格式为yyyyMMddHHmmss，如：2021年3月15日15点50分12秒表示为：20210315155012 |
| 加密签名类型 | signType | 是 | E | SM2 | 商户生成签名和加密字符串使用的算法类型，见附录【签名类型】 |
| 签名证书序列号 | signSn | 是 | S(10) | 1 | 发送方公钥证书序列号，用于接收方验签证书选择 |
| 加密证书序列号 | ncrptnSn | 是 | S(10) | 1 | 接收方公钥证书序列号，用于接收方解密证书选择 |
| 数字信封 | dgtlEnvlp | 否 | S | 使用接收方公钥加密的对称密钥，并做16进制转码，是否需要传值，详见各个业务接口说明 | |
| 签名串 | signStr | 是 | S | 使用发送方私钥签名的非对称密钥，并做16进制转码 | |
| 业务参数 | bizContent | 是 | S | 业务数据报文，JSON格式，具体见各业务接口定义 |
请求参数示例
merId=102004459, terId=100005196, method=unified_order, charset=UTF-8, version=1.0, format=json, timestamp=20260226100123, signType=RSA, signSn=1, ncrptnSn=1, dgtlEnvlp=, signStr=242a9022ffc5ebf00110fd0472c22f42a50e5f43edff87ad3eee8aeb324da15eab92257af150a5c8fb6c4045d6fe5c30059beea7b4cc6da0d7791d1f9622dedad078ea5056c3e3c66188b50ed76839499f595aaeef5b71310a7f07576100f4b8208e43e42988e6842a55d1823b566f85ae141d75ed78b797b34e461450d9adc2196b8ad76f5c210361b04912cdf85dd493aee7b6efda99984df01a836da79ec37cd9dfc14c4092e57d3f83bc903db5d14392d60331115712c40b070e68d570e5a711f98fd73e041d14201044ca9326f83e9af9bf3ad727da25a089d91ad70d93fb0133954dabd346a22e1c8b6b6870609b0881b3c6458b05d8435f09d2fd35f6, bizContent={"forbidCredit":"0","riskInfo":{"clientIp":"181.219.133.152","locationPoint":""},"payExtend":{"store_id":"","hb_fq_seller_percent":"","hb_fq_num":"","subject":"商品名称","disable_pay_channels":"","area_info":"","enable_pay_channels":""},"subMchId":"","prodType":"ORDINARY","terId":"100005196","timeExpire":"120","totalAmt":"100000","outTradeNo":"OTN1772071283428","reqReserved":"","txnTime":"20260226100123","notifyUrl":"http://xxxx.test.com.cn/appv3/addBankResult","merId":"102004459","pageUrl":"","attach":"","payCode":"ALIPAY_NATIVE","feeMerId":"","txnAmt":"100000"}响应参数
- 响应参数格式约定如下：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态码 | returnCode | 是 | S(16) | SUCCESS | 成功：SUCCESS 失败：FAIL 通信标识，非交易标识 |
| 返回信息 | returnMsg | 是 | S(128) | OK | 当returnCode返回FAIL时返回错误信息，如：验签失败 解密失败 商户号不存在 参数格式验证错误等 检查报文重新发起请求 |
当returnCode返回SUCCESS时，以下字段有值：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 字符集 | charset | 是 | S(16) | UTF-8 | 字符集编码，固定值UTF-8 |
| 接口版本号 | version | 是 | S(8) | 1.0 | 对应接口的版本号，固定值1.0 |
| 格式化类型 | format | 是 | S(8) | json | 各个接口业务参数的格式化类型，固定值json |
| 加密签名类型 | signType | 是 | E | SM2 | 与商户原请求签名加密类型一致，如：商户请求采用国密类型，则对应返回也采用国密类型 |
| 签名证书序列号 | signSn | 是 | S(10) | 1 | 发送方公钥证书序列号，用于接收方验签证书选择，固定值1 |
| 加密证书序列号 | ncrptnSn | 是 | S(10) | 1 | 接收方公钥证书序列号，用于接收方解密证书选择，固定值1 |
| 数字信封 | dgtlEnvlp | 否 | S | 使用接收方公钥加密的对称密钥，并做16进制转码，返回是否有值，详见各个业务接口返回参数说明 | |
| 签名串 | signStr | 是 | S | 使用发送方私钥签名的非对称密钥，并做16进制转码 | |
| 返回参数 | dataContent | 是 | S | 业务数据报文，JSON格式，具体见各业务接口返回参数说明 |
返回参数示例
merId=102004459, terId=100005196, charset=UTF-8, version=1.0, format=json, returnMsg=OK, returnCode=SUCCESS, signType=RSA, signSn=1, ncrptnSn=1, signStr=84DAC00BE960B1DFEA92097439598D64CE256F83C11B286473A9533003FFF671A785B77C18A9FE7709D3B9CF8E98D3B34073BAF9D35E3E1DBE5415A76BF5C56342E02271B468BA486EF4E0331852CEA4006859F889498363DD2FBF4B2296356FCEA3864073ED2696026AEC13364FF4EF6CD2D86D25858585D022895F29C16614, dataContent={"merId":"102004459","terId":"100005196","resultCode":"SUCCESS","outTradeNo":"OTN1772071283428","txnState":"WAIT_PAYING","tradeNo":"260226111101110006060848","reqChlNo":"26022610011110191231100006206490","payCode":"ALIPAY_NATIVE","chlRetParam":{"qr_code":"https://qr.alipay.com/bax01903htsgp8qqaxjp5061","order_id":260226131006060848}}异步通知
宝付请求商户系统，特定情况下订单的最终处理结果，如：统一下单，退款等。
- 通知参数格式约定如下：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 字符集 | charset | 是 | S(16) | UTF-8 | 字符集编码，固定值UTF-8 |
| 接口版本号 | version | 是 | S(8) | 1.0 | 对应接口的版本号，固定值1.0 |
| 格式化类型 | format | 是 | S(8) | json | 各个接口业务参数的格式化类型，固定值json |
| 通知类型 | notifyType | 是 | E | PAYMENT | 本次通知的订单类型，见附录：【通知类型】 |
| 加密签名类型 | signType | 是 | E | SM2 | 与商户原请求签名加密类型一致，如：商户请求采用国密类型，则对应返回也采用国密类型 |
| 签名证书序列号 | signSn | 是 | S(10) | 1 | 发送方公钥证书序列号，用于接收方验签证书选择，固定值1 |
| 加密证书序列号 | ncrptnSn | 是 | S(10) | 1 | 接收方公钥证书序列号，用于接收方解密证书选择，固定值1 |
| 数字信封 | dgtlEnvlp | 否 | S | 使用接收方公钥加密的对称密钥，并做16进制转码，返回是否有值，详见各个业务接口返回参数说明 | |
| 签名串 | signStr | 是 | S | 使用发送方私钥签名的非对称密钥，并做16进制转码 | |
| 返回参数 | dataContent | 是 | S | 业务数据报文，JSON格式，具体见各业务接口返回参数说明 |
异步通知返回参数示例
merId=102004459, terId=100005196,charset=UTF-8, version=1.0, format=json, notifyType=PAYMENT, signType=RSA, signSn=1, ncrptnSn=1, dgtlEnvlp=, signStr=5465EF667DAEA5068C94390AC665E4C682A99B1C68ADFE6C55F05A3CEA472F95212BD9A8545B61E285665AF68E595FCC46B368B0FE0F8B8DA2A6264794FEB8E2A258522093C8529E7A942ECE955ECCADE2A176345F2307F8E5E9ED7FE944B80D7AD7C8811FA46B9D94EB42B2CFF9695396ACC737553B5312B77DA8CF10C11243, dataContent={"finishTime":"20260226105710","tradeNo":"260226111101110006060862","resultCode":"SUCCESS","clearingDate":"20260226","terId":100005196,"feeAmt":10,"chlRetParam":{"transaction_id":"4200001022202104230439766441","bank_type":"LQT","openid":"oUpF8uMm_XdrKcZ3mO813NATnON0","sub_openid":"ojGnc4jPu-_lGU4xwqerwe"},"succAmt":10000,"txnState":"SUCCESS","outTradeNo":"OTN1772074606131","merId":102004459,"reqChlNo":"26022610561110191231100006206509","payCode":"WECHAT_JSAPI"}异步通知说明：
- 异步通知以POST方式访问商户设置的通知URL
- 商户系统接收到宝付异步通知，并正确的完成相应的业务处理后，必须同步返回大写OK字符串。
- 由于网络抖动等异常因素以及商户侧未按照约定返回OK，宝付支付系统会多次请求商户侧通知地址，商户系统必须能够正确处理重复的通知。建议商户系统收到通知进行处理时，采用数据锁进行并发控制，检查对应业务数据状态，如未处理，则进行处理，防止多次通知造成资金损失。
- 宝付支付系统会在未正常收到商户侧返回OK时，在24小时内最多通知10次，若在10次通知次数完成后依然未正常收到商户侧按约定返回OK，则不再进行通知，商户应调用订单查询接口确认订单状态。
作者：杜青峰 创建时间：2025-03-25 15:09
最后编辑：xiaofeng 更新时间：2026-03-19 15:06
最后编辑：xiaofeng 更新时间：2026-03-19 15:06
