本开发文档的阅读对象为:具有一定开发能力，了解PHP、JAVA、.NET等开发语言的开发、维护或管理人员。

本文档定义CHINAPNR支付网关商户接入接口规范，提供接口报文参数说明、示例报文、信息安全解决方案，并给出相关问题说明等，以帮助商户技术人员接入，便于尽快投入使用。

1. 商户会员号

   Chinapnr网关支付时提交的为商户会员号,并非商户号,会员号=商户号+"01"(如商户号为abc时，会员号为abc01)

商户接入Chinapnr网关支付时，调用API须遵循以下规则：

场景介绍

聚合支付宝、微信扫码支付、快捷支付、网银支付适用于PC端。

微信公众号支付，微信小程序支付，微信APP支付，H5形式的快捷支付。 适用于移动端。

第一步：用户击进入商户网页购物进行支付

图3.0 商户移动端下单

第二步：商户调用聚合支付，返回付款二维码给用户。用户使用微信/支付扫码支付完成。

第三步：支付成功，商户后台得到支付成功的通知。并且Chinapnr返回商户页面，显示购买成功。该页面由商户自定义。

图3.3 返回商户页面

概述

本文档展示了如何从零开始，与Chinapnr跨境聚合支付对接的流程。

第一步：获取账号信息

1. 商户需与前端销售沟通开通测试账号或生产账号，并提供接受邮箱地址。

2. 1-2个工作日内由开通组负责将开通的账号信息发送至商户邮箱。

第二步：配置密钥

1. 开发者调用接口前需要先生成RSA密钥，RSA密钥包含私钥、公钥。生成密钥后在商户后台进行密钥配置，配置完成后可发起交易。详细步骤请参考配置秘钥。

第三步：搭建和配置开发环境

1. 下载示例代码Demo
   为了帮助开发者调用开放接口，我们提供了示例代码下载，包含JAVA、PHP和.NET三语言版本，封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的Demo并引入您的开发工程下载地址。

2. 将Demo运行成功，并将代码集成到您的项目中，记得修改商户号，终端号，和私钥证书。如生产环境，还需更换Chinapnr生产公钥证书。

调用流程

接口调用时序图：

图4.1 聚合支付调用时序图

1. 用户（交易过程中的买家或实际支付人，以下简称用户）在商户（交易过程中的卖家或者电商平台，以下简称商户）网站下单完毕后确认进行在线支付。

2. 用户点击确认按钮后，商户系统收集订单信息并通过《跨境聚合支付接口》下单接口向汇付天下（以下简称汇付）发起支付请求。
   

3. 汇付对商户的支付请求进行处理并返回支付二维码.
   

4. 用户扫描二维码完成支付。

5. 支付结果页面跳转到汇付后，汇付会进行相关处理，并继续将页面跳转到由商户提供的支付结果页面，汇付在跳转时所携带的参数请参照《跨境聚合支付接口》中的返回参数章节。

6. 商户系统根据收到的支付结果进行相应的展示，告知用户该笔订单的支付结果。

7. 同时汇付系统会在后台通过支付结果通知接口通知商户系统该笔订单的支付结果，该地址不能与第6步中提供的支付结果页面地址相同。 后台通知以收到商户系统返回的http状态码200表示成功，否则将继续通知，如果连续通知10次仍不成功将停止通知。

注意：为确保安全，商户在收到汇付支付结果通知后，务必先验证返回的签名字段。

概述

Chinapnr开放平台采用了 RSA 安全签名机制，开发者可以通过Chinapnr公钥验证消息来源，同时可使用自己的私钥对信息进行加密。RSA 算法及数字签名机制是Chinapnr平台与开发者网关安全通信的基础，若开发者不熟悉 RSA 及数字签名，请先查阅相关资料。

RSA 私钥及公钥生成

1. 生成 RSA 私钥及公钥，请详见“附录一:私钥公钥生成及范例”。 生成的文件格式如：客户私钥private-rsa.pfx，客户公钥public-rsa.cer。

商户上传公钥

注意：

1. 上传商户公钥前需先联系前端获取商户后台账号和密码，并将客户公钥public-rsa.cer文件前缀名称修改为商户号。 如开通的商户号为10012159865，则证书修改为10012159865.cer上传。

商户平台登录地址 测试环境 / 生产环境进入Platform Management菜单Certificate Management菜单，转入如下界面:

图5.1 上传公钥

在证书管理，输入邮箱，点击Do Upload上传证书。页面提示上传成功，证书列表中可以查看新增证书，状态为1有效。

下载Chinapnr公钥

点击Download下载系统公钥用于接收跨境系统返回时验签。

图5.2 下载Chinapnr公钥

注意：

不同环境Chinapnr公钥证书需在不对环境的商户后台下载。

接口参数说明请参见《跨境聚合支付接口》

API请求

Chinapnr开放平台的OpenAPI调用采取POST方式（application/x-www-form-urlencoded），内容通过键值对（Key-Value）的形式作为参数传入。

请求示例：

pageUrl=http://127.0.0.1:8081/QAMOCK-Test/notifyReceiverPg.do
signType=4
refererUrl=http://www.baidu.com
settlementCurrency=CNY
version=4.0
inputCharset=1
customerId=1001
bgUrl=http://127.0.0.1:8081/QAMOCK-Test/notifyReceiverBg.do
inquireTrxNo=
orderAmount=600
productNum=1
payerContactType=2
orderId=20170821175929871
payerIdentityCard=320125198805232313
merchantAcctId=1001215986501
terminalId=0020001
orderCurrency=CNY
divDetails=
payerContact=15800000000
orderTime=20170821175928
customerIp=127.0.0.1
productId=100003
productDesc=IPHONE6港版								
ext1=ext1
ext2=ext2
signMsg=TgPPi15HAgjVvjeRl8WH7tFL8DCWfaIQFUhxYjPenuaYz6JwVv9ExpCEckBcp9oMfkipTSOTMtaP2UYf3UUfe+kXiBr5OSML3chY5ZRHYTDKQ+NZKYY+yK7tZHQ6bNEvC3nG3cD+emeJj9oIoG6+AAlxxPtEuuzy+I+CzwWEI5E=
payType=30
language=1
mobileNumber=15811111111
orderTimeout=60
productName=IPHONE6
payerName=张三
cardNumber=6228480402564890018
redoFlag=1
								

在提交参数中需要对传入的数据进行签名组成signMsg字段，签名方法如下：

1.将所有非空参数（sign除外）按照signMsg签名串:

inputCharset={inputCharset}&pageUrl={pageUrl}&bgUrl={bgUrl}&version={version}&language={language}&signType={signType}&merchantAcctId={merchantAcctId}&terminalId={terminalId}&payerName={payerName}&payerContactType={payerContactType}&payerContact={payerContact}&payerIdentityCard={payerIdentityCard}&mobileNumber={mobileNumber}&cardNumber={cardNumber}&customerId={customerId}&orderId={orderId}&inquireTrxNo={inquireTrxNo}&orderCurrency={orderCurrency}&settlementCurrency={settlementCurrency}&orderAmount={orderAmount}&orderTime={orderTime}&productName={productName}&productNum={productNum}&productId={productId}&productDesc={productDesc}&ext1={ext1}&ext2={ext2}&payType={payType}&refererUrl={refererUrl}&customerIp={customerIp}&orderTimeout={orderTimeout}&divDetails={divDetails}&redoFlag={redoFlag}

按顺序用&连接起来组成字符串,格式是:p1=v1&p2=v2。如：

								inputCharset=1&pageUrl=http://127.0.0.1:8081/QAMOCK-Test/notifyReceiverPg.do&bgUrl=http://127.0.0.1:8081/QAMOCK-Test/notifyReceiverBg.do&version=4.0&language=1&signType=4&merchantAcctId=1001215986501&terminalId=0020001&payerName=张三&payerContactType=2&payerContact=15800000000&payerIdentityCard=320125198805232313&mobileNumber=15811111111&cardNumber=6228480402564890018&customerId=1001&orderId=20170821174125189&orderCurrency=CNY&settlementCurrency=CNY&orderAmount=600&orderTime=20170821174110&productName=IPHONE6&productNum=1&productId=100003&productDesc=IPHONE6港版&ext1=ext1&ext2=ext2&payType=30&refererUrl=http://www.baidu.com&customerIp=127.0.0.1&orderTimeout=60&redoFlag=1
								

2.进行RSA签名后获得sign，再经过Base64编码，具体加签代码 demo，最终的请求报文样式参考如下：

REQUEST URL: https://global.chinapnr.com/pay/recvquickpay.htm
REQUEST METHOD: POST
CONTENT:
pageUrl=http://127.0.0.1:8081/QAMOCK-Test/notifyReceiverPg.do
signType=4
refererUrl=http://www.baidu.com
settlementCurrency=CNY
version=4.0
inputCharset=1
customerId=1001
bgUrl=http://127.0.0.1:8081/QAMOCK-Test/notifyReceiverBg.do
inquireTrxNo=
orderAmount=600
productNum=1
payerContactType=2
orderId=20170821175929871
payerIdentityCard=320125198805232313
merchantAcctId=1001215986501
terminalId=0020001
orderCurrency=CNY
divDetails=
payerContact=15800000000
orderTime=20170821175928
customerIp=127.0.0.1
productId=100003
productDesc=IPHONE6港版
ext1=ext1
ext2=ext2
signMsg=TgPPi15HAgjVvjeRl8WH7tFL8DCWfaIQFUhxYjPenuaYz6JwVv9ExpCEckBcp9oMfkipTSOTMtaP2UYf3UUfe+kXiBr5OSML3chY5ZRHYTDKQ+NZKYY+yK7tZHQ6bNEvC3nG3cD+emeJj9oIoG6+AAlxxPtEuuzy+I+CzwWEI5E=
payType=30
language=1
mobileNumber=15811111111
orderTimeout=60
productName=IPHONE6
payerName=张三
cardNumber=6228480402564890018
redoFlag=1
								

注意：

1. 没有值的参数无需传递,也无需包含到待签名数据中。

2. 签名时将字符转化成字节流时指定的字符集UTF8。

3. 根据HTTP协议要求，传递参数的值中如果存在特殊字符（如：&、@等），那么该值需要做URL Encoding，这样请求接收方才能接收到正确的参数。此时，待签名数据应该是原始值而不是encoding之后的值。 例如:调用某接口需要对请求参数 email 进行数字签名,那么待签名数据应该是：email=test@abc.com,而不是 email=test%40abc.com。

返回结果

返回示例：

dealTime=20170821180822
errCode=000000
merchantAcctId=1001215986501
orderTime=20170821180751
orderCurrency=CNY
dealId=1000015038
version=4.0
bankId=ccb
terminalId=0020001
payResult=10
ext1=ext1
orderAmount=600
ext2=ext2
signMsg=K+TAl+GOx89Pu27KqLfgLvfTZc2T491Mn8f6hO5xFxsJL/sgtsgM7/cwpJCxZJMEJE/wg5M30PKB6XKc/7BSrPlYtKUbbb0xm5Pi1btbKCprl/y/xYjg1JWaKpmQKv/kYobNd2LZFssA6TOTUQn3x9+wEK0N9Z/dUo+ISLNRbW0=
payType=30
orderId=20170821180758470
								

调用Chinapnr开放平台接口后，Chinapnr会向开发者提交的pageUrl地址同步返回支付结果。为保证信息安全，会经Chinapnr私钥进行RSA加密，开发者收到消息后可通过ChinapnrRSA公钥进行解密。

1.将所有返回参数（signMsg除外）按照signMsg验签串按顺序拼接:

bankDealId={bankDealId}&bankId={bankId}&dealId={dealId}&dealTime={dealTime}&errCode={errCode}&ext1={ext1}&ext2={ext2}&merchantAcctId={merchantAcctId}&orderAmount={orderAmount}&orderCurrency={orderCurrency}&orderId={orderId}&orderTime={orderTime}&payResult={payResult}&payType={payType}&terminalId={terminalId}&version={version}

组成待验签字符串，如：

bankId=ccb&dealId=1000015038&dealTime=20170821180822&errCode=000000&ext1=ext1&ext2=ext2&merchantAcctId=1001215986501&orderAmount=600&orderCurrency=CNY&orderId=20170821180758470&orderTime=20170821180751&payResult=10&payType=30&terminalId=0020001&version=4.0

2.将签名参数（signMsg）使用base64解码为字节码串

3.使用RSA的验签方法，通过签名字符串、签名参数（经过base64解码）及Chinapnr公钥验证签名。具体验签方法 请详见Demo

支付完成后，Chinapnr会向开发者提交的bgUrl地址后台异步返回支付结果。商户处理支付结果以支付结果通知结果为准。

接口返回参数说明请参见《跨境聚合支付接口》

支付结果通知

支付结果通知示例：

dealTime=20170821180822
errCode=000000
merchantAcctId=1001215986501
orderTime=20170821180751
orderCurrency=CNY
dealId=1000015038
version=4.0
bankId=ccb
terminalId=0020001
payResult=10
ext1=ext1
orderAmount=600
ext2=ext2
signMsg=MnUsvrgsAS0ywOsp0w%2Fr1ihlfBLY3fHjBrhevejUosPC2hC7CFsmflv3LdWxKmYXDUUSJpYw7XxMwNUiwwZGO3hLLaVvUJKJeGWOrQ4E3LnKWqxgmiGeDyttKq2UJhvT7O067Rll%2BQDfaE254GLxzztgdjFNJMESoxLw2ckOLE8%3D
payType=30
orderId=20170821180758470
								

支付结果通知的验签

1.将所有返回参数（signMsg除外）按照signMsg验签串按顺序拼接:

bankDealId={bankDealId}&dealId={dealId}&dealTime={dealTime}&errCode={errCode}&ext1={ext1}&ext2={ext2}&merchantAcctId={merchantAcctId}&orderAmount={orderAmount}&orderCurrency={orderCurrency}&orderId={orderId}&orderTime={orderTime}&payResult={payResult}&payType={payType}&terminalId={terminalId}&version={version}

组成待验签字符串，如：

dealId=1000015038&dealTime=20170821180822&errCode=000000&ext1=ext1&ext2=ext2&merchantAcctId=1001215986501&orderAmount=600&orderCurrency=CNY&orderId=20170821180758470&orderTime=20170821180751&payResult=10&payType=30&terminalId=0020001&version=4.0
							

2.将签名参数signMsg和拼接的验签字符串进行URLDecoder。

如C#代码，signMsg为通知中的signMsg字段，signMsgVal为拼接的验签串：
String signMsgDecode = HttpUtility.UrlDecode(signMsg);
String signMsgValDecode = HttpUtility.UrlDecode(signMsgVal);

3.将URLDecoder后的签名参数（signMsg）使用base64解码为字节码串。

4.使用RSA的验签方法，通过签名字符串、签名参数（经过base64解码）及Chinapnr公钥验证签名。具体验签方法 demo

商户业务处理注意事项

1.商户必须根据Chinapnr不同类型的业务通知，正确的进行不同的业务处理，并且过滤重复的通知结果数据。

2.Chinapnr异步通知以通知地址返回HTTPSTATUS为200认为成功，否则会一直通知，通知策略是一共通知15次，前面每隔10s通知一次 一共通知6次每次，后9次通知时间间隔增加（N*60s+30s，N为第几次通知，如第7次通知间隔第一次7min30s）。

3.在Chinapnr的业务通知中，只有交易通知payResult状态为10时，Chinapnr才会认定为买家付款成功。如果商户未正确处理业务通知，存在潜在的风险，商户自行承担因此而产生的所有损失。

商品编码列表

1.1留学

{
studentInfo: {
“payAddr”:””; ”payType”:””; ”courseType”:””; ”studentCertId”:””; “studentCertType”:””; ”studentCertEndDate”:“”; “studentNo”:””; “subProductCode”:””}
}

字段枚举

1.2物流

{
logisticsInfo: {
"subProductCode":""}
}

字段枚举

跨境人民币付汇接口：

银行受理能力

网银

网银支持的银行列表以及对借记卡，信用卡限额的说明。详细可下载银行受理文件

图7.1 网银受理能力表

快捷支付

快捷支付支持的银行列表以及对限额说明。详情的借记卡，信用卡受理能力请下载受理文件查看

注意:有些银行卡需要开通银联在线支付业务：

1、建设银行、中国银行、农业银行、光大、兴业、中信、渤海银行，上述银行卡有卡就能用，功能已默认开通。

2、交通银行、平安、浦发、邮储、上海银行，上述银行卡需通过https://online.unionpay.com/portal/open/init.do?entry=open开通银联在线支付业务。

图7.3 快捷支付受理能力表

银联app

银联app银行与限额：

图7.4 银联app受理能力表

转账支付

转账支付受理能力：

图7.5 转账支付受理能力表

产品集成

1. 商户需上传唯一的商户订单号(orderId)，同时建议商户订单号中包含年月日等时间信息。

2. 商品ID(productId)需根据商品代码传递，商品名称(productName)需传递。

3. Chinapnr默认银行支付超时时间12小时，即晚于该订单的最晚付款时间后，将关闭交易。

交易查询

商户可在商户后台进行交易查询，也可通过查询接口查询。

1. 进入商户后台“交易管理”=>“交易查询”菜单，输入订单号，Chinapnr交易流水号发起查询。

   

   图6.1 商户后台交易查询

2. 网关交易在未收到支付结果通知时通过查询接口查询支付结果，查询接口未返回支付成功，则继续轮询。

   详情请参见交易查询接口。

退款

商户因业务原因需要退款时，可通过成功交易的商户订单号或Chinapnr交易号进行退款。Chinapnr退款支持单笔交易分多次退款，多次退款需要提交Chinapnr交易号并设置不同的退款单号；总退款金额不能超过用户实际支付金额。

1. 对接退款接口。

   详情请参见退款接口。

对账

商户可通过接口下载指定日期（当天除外）的业务明细账单文件，并结合自身业务系统实现自动对账。

1. 商户可在商户后台发起日终查询,进入“交易管理”=>“日终交易查询”菜单，选择要查询的交易所对应的终端号，选择日期，点击查询。

   对查询出的日终列表，选择点击下载按钮下载日终对账文件。

   

   图6.4 商户后台日终文件查询

2. 对接日终文件查询接口

   详情请参见日终交易查询。

DEMO下载

注意：Demo下载后可直接运行，也可将项目里商户号，终端号，私钥证书（**.pfx）更换成已开通测试商户的。

文档下载

1.订单信息的签名不正确

确保私钥证书正确。

确保加签字段和加签顺序正确，可对照Demo对比

2.订单返回信息验签失败

确保公钥证书正确，与所提交环境匹配，可在对应环境商户后台下载。

确保验签字段和验签顺序正确，可对照Demo对比

3.网关发起交易,报商户号不存在或未开通

网关发起交易时,提交的并非是商户号,而是会员号,会员号=商户号+“01”。

4.TLS1.0 SSL3.0等协议无法正常进行网关交易

根据PCI-DSS检查要求，正式环境禁止使用低版本的SSL3.0 TLS1.0 TLS1.1等协议,请使用高于TLSv1.2及以上发送请求，推荐使用TLSv1.2

5.商户site后台证书上传失败

跟商户确认，证书生成“req -new -x509 -key private-rsa.key -days 750 -out public-rsa.cer，按enter”，这里的天数是不是不符合规范，可以查看site应用日志

测试环境证书过期，麻烦测试环境去掉证书到期的验证，就可以了，不影响验签

6.支付宝，微信支付返回支付失败、银行授权失败？

测试环境按照交易规则进行支付，

收单：交易金额transAmt（0,10000) 交易成功，transAmt[10000，50000） 交易失败

退款：退款金额transAmt（0，50）退款成功； transAmt[50，100）退款失败

微信直连退款：transAmt（2，50)，退款成功； transAmt[50，100)退款失败

7.提交支付申请，返回产品功能未开通，指定支付方式不存在

麻烦检查终端号是否提交正确，终端号与提交支付方式是否相符，如果都相符，再联系联调同事处理。

8.商户提交申请，返回系统错误，签名错误

1.优先确认商户号是否+01；2.确认请求接口地址是否正确。3.确认商户证书是否上传。4.确认用的私钥证书和上传到我司后台的公钥证书是否一致。5.确认加签的参数和加签顺序是否符合我们文档上的要求。6.确认商户是否做过转码操作urldecode

9.我司公私钥证书作用

商户自行生成一公私钥证书

私钥-->向我司请求时加签

公钥-->上传到我司后台,我司用来对贵司的请求进行验签

商户后台下载公钥证书 ChinaPnR.ras.cer-->贵司用来验我司同步返回或异步通知的签名.由我司提供,在商户后台可自行下载.

10.退款多久可以收到异步通知

我司一般在退款订单提交后，即时执行任务上送通道发起退款，商户会在1-2分终左右收到退款异步通知

11.支付宝扫码支付，发起关单，银行授权失败

请使用支付宝app扫码1分钟后，再发起关单

12.支付成功，未接收到回调异步

烦请确认接口上传bgUrl异步通知地址是否可以正常使用，若可以，烦请联系我司运维同事

13.接收到我司异步通知后，返回我司什么数据

Chinapnr异步通知以通知地址返回HTTPSTATUS为200认为成功，否则会一直通知，通知策略是一共通知15次，前面每隔10s通知一次 一共通知6次每次，后9次通知时间间隔增加（N*60s+30s，N为第几次通知，如第7次通知间隔第一次7min30s）。商户在接受到Chinapnr异步通知后，应返回成功接受内容，如"SUCCESS"

OpenSSL工具安装

1.Linux用户（以Ubuntu为例）

sudo apt-get install openssl
							

2.Windows用户开发者可以在OpenSSL官方网站下载Windows的OpenSSL安装包进行安装。或直接下载

RSA私钥及公钥生成

生成证书days在730-780之间

1.Linux用户（以Ubuntu为例）

$ openssl   进入OpenSSL程序
OpenSSL> genrsa -out private-rsa.key 1024   生成私钥
OpenSSL> req -new -x509 -key private-rsa.key -days 750 -out public-rsa.cer     生成公钥
OpenSSL> pkcs12 -export -name test-alias -in public-rsa.cer -inkey private-rsa.key -out private-rsa.pfx    生成证书，密码和别名需记住
OpenSSL> exit   # 退出OpenSSL程序
							

2.Windows用户在cmd窗口中进行以下操作：

C:\Users\Hammer>cd C:\OpenSSL\bin     进入OpenSSL安装目录
C:\OpenSSL\bin>openssl.exe            进入OpenSSL程序
OpenSSL> genrsa -out private-rsa.key 1024   生成私钥
OpenSSL> req -new -x509 -key private-rsa.key -days 750 -out public-rsa.cer     生成公钥
OpenSSL> pkcs12 -export -name test-alias -in public-rsa.cer -inkey private-rsa.key -out private-rsa.pfx    生成证书，密码和别名需记住
OpenSSL> exit   # 退出OpenSSL程序
							

注意：

1.对于使用Php的开发者，需要将“private-rsa.pfx”证书转换为“private-rsa.pem”，输入转换命令pkcs12 -in dc-rsa.pfx -passin pass:“此处输入商户第3步设置的密码” -nodes -out private-rsa.pem。

跨境公钥转pem（cer转pem）:x509 -in C:\OpenSSL\bin\ChinaPnR.rsa.cer -out C:\OpenSSL\bin\ChinaPnR.rsa.pem

2.如第二步报错，则根据工具所在路径指定下配置文件，如命令改为：req -new -x509 -key private-rsa.key -config "C:\OpenSSL\bin\openssl.cnf" -days 750 -out public-rsa.cer

私钥及公钥文件示例

经过以上步骤，开发者可以在当前文件夹中（Windows用户在C:\OpenSSL\bin）看到private-rsa.pfx和public-rsa.cer两个文件，前者为私钥，后者为公钥。开发者将私钥保留，将公钥提交给Chinapnr网关，用于信息加密及解密。公钥需修改前缀为商户号，并上传至跨境系统商户后台。以下为使用OpenSSL生成的私钥文件和公钥文件示例：

1.私钥文件示例（Java使用）

								-----BEGIN PRIVATE KEY-----
    MIICeAIBADANBgkqhkiG9w0BAQEFAASCAmIwggJeAgEAAoGBAN0yqPkLXlnhM+2H
    /57aHsYHaHXazr9pFQun907TMvmbR04wHChVsKVgGUF1hC0FN9hfeYT5v2SXg1WJ
    Sg2tSgk7F29SpsF0I36oSLCIszxdu7ClO7c22mxEVuCjmYpJdqb6XweAZzv4Is66
    1jXP4PdrCTHRdVTU5zR9xUByiLSVAgMBAAECgYEAhznORRonHylm9oKaygEsqQGk
    YdBXbnsOS6busLi6xA+iovEUdbAVIrTCG9t854z2HAgaISoRUKyztJoOtJfI1wJa
    QU+XL+U3JIh4jmNx/k5UzJijfvfpT7Cv3ueMtqyAGBJrkLvXjiS7O5ylaCGuB0Qz
    711bWGkRrVoosPM3N6ECQQD8hVQUgnHEVHZYtvFqfcoq2g/onPbSqyjdrRu35a7P
    vgDAZx69Mr/XggGNTgT3jJn7+2XmiGkHM1fd1Ob/3uAdAkEA4D7aE3ZgXG/PQqlm
    3VbE/+4MvNl8xhjqOkByBOY2ZFfWKhlRziLEPSSAh16xEJ79WgY9iti+guLRAMra
    vGrs2QJBAOmKWYeaWKNNxiIoF7/4VDgrcpkcSf3uRB44UjFSn8kLnWBUPo6WV+x1
    FQBdjqRviZ4NFGIP+KqrJnFHzNgJhVUCQFzCAukMDV4PLfeQJSmna8PFz2UKva8f
    vTutTryyEYu+PauaX5laDjyQbc4RIEMU0Q29CRX3BA8WDYg7YPGRdTkCQQCG+pjU
    2FB17ZLuKRlKEdtXNV6zQFTmFc1TKhlsDTtCkWs/xwkoCfZKstuV3Uc5J4BNJDkQ
    OGm38pDRPcUDUh2/
    -----END PRIVATE KEY-----
							

3.公钥文件示例

								-----BEGIN CERTIFICATE-----
MIIDNzCCAqCgAwIBAgIJAJaZj8YlPQcIMA0GCSqGSIb3DQEBBQUAMHExCzAJBgNV
BAYTAkhLMQswCQYDVQQIEwJISzELMAkGA1UEBxMCSEsxDTALBgNVBAoTBE1QQVkx
DTALBgNVBAsTBE1QQVkxDTALBgNVBAMTBE1QQVkxGzAZBgkqhkiG9w0BCQEWDE1Q
QVlAMTIzLkNPTTAeFw0xNjA3MDUxMDM5NDJaFw0xODA3MjUxMDM5NDJaMHExCzAJ
BgNVBAYTAkhLMQswCQYDVQQIEwJISzELMAkGA1UEBxMCSEsxDTALBgNVBAoTBE1Q
QVkxDTALBgNVBAsTBE1QQVkxDTALBgNVBAMTBE1QQVkxGzAZBgkqhkiG9w0BCQEW
DE1QQVlAMTIzLkNPTTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAyiVbdBOF
Qtb03wKw+7oR7bA32vi5/XkJ33CbzdiID+ZK6lkeeRlJVIQvf2UsfScIeTLE/Nyn
lapF12Gsw9dVoiCzrScagn3kknFcE7fM2x4kyLLNQdJgJvb7jCRl/oMOziVT+z5R
cZ8SS11vO5Dk5kx8W4n66ldoyDeUVXArlCcCAwEAAaOB1jCB0zAdBgNVHQ4EFgQU
epQ9Qvg/VE5nb69L+D08eqn6/E8wgaMGA1UdIwSBmzCBmIAUepQ9Qvg/VE5nb69L
+D08eqn6/E+hdaRzMHExCzAJBgNVBAYTAkhLMQswCQYDVQQIEwJISzELMAkGA1UE
BxMCSEsxDTALBgNVBAoTBE1QQVkxDTALBgNVBAsTBE1QQVkxDTALBgNVBAMTBE1Q
QVkxGzAZBgkqhkiG9w0BCQEWDE1QQVlAMTIzLkNPTYIJAJaZj8YlPQcIMAwGA1Ud
EwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADgYEAOHgqqxMLoaUW/i43KtTHFGciwr9m
OkusX4B4kx5sKN8Ed110iyRPixMKCslV2EHP4uIVAMWhEw+AxULbJte86r8ryr/m
Jc0PR4U9vrpQxdWLsBh8lhKgC4GVJb8jkwcVkjF/XvvVUp/VqHto+LBnjdNAXqZa
GbuKXbLTnmIwGes=
-----END CERTIFICATE-----
							

微信/支付宝交易（生产环境）的默认前提：

1.微信公众号支付（JSAPI）时序图

2.微信小程序支付时序图

3.微信APP支付（通过小程序支付间接实现）时序图

4-1.支付宝扫码-跳转汇付网关模式-PC（二维码两小时失效）

4-2.支付宝扫码-非跳转模式（下单后返回codeUrl）（二维码两小时失效）

5.移动端聚合支付

6.微信公众号包装为微信扫码支付

7.H5拉起小程序并使用小程序支付

8.转账支付-网关模式

9.转账支付-api

10.分账交易流程

alt用户开户：步骤1,2,3：调用个人开户或企业开户接口：个人用户开户接口 ；企业用户开户接口

alt交易及分账：步骤4,5:调用聚合支付接口和步骤6,7,8：分账接口：聚合支付接口 ；收单分账接口

alt交易退款：步骤9,10：调用交易退款接口：交易退款接口

alt分账回退：步骤11,12,13:调用分账回退接口分账回退（目录4）

alt分账完结：步骤14,15:调用分账完结接口分账完结（目录6）

11.银联APP支付

银联APP支付支持银行APP、云闪付APP等多种APP支付，商家APP通过整合银联SDK实现一次对接支持多种支付APP。

银联SDK下载地址：https://open.unionpay.com/tjweb/acproduct/list?apiSvcId=3021&index=4

12.广告业务B2B支付流程

该方案适用于广告代理服务平台的客户为企业、并且使用企业网银支付的场景，主要是广告服务平台基于自身资金来源与签约协议匹配性要求（合作客户为A，那么付款对象应该也为A；不为A时广告服务平台不接受，可能直接发起退款）。

1.支付申请时提交期望的企业付款人信息：
指定上送期望付款人，格式为：
{ "companyName": "企业名称", "companyLicenseNo": "DZ1000-11", "legalPersonName": "张三", "legalPersonIdNo": "342623198812171432" }
（1）付款企业名称：companyName
（2）付款企业营业执照编码：companyLicenseNo（统一社会信用代码）
（3）付款企业法人姓名：legalPersonName
（4）付款企业法人身份证号：legalPersonIdNo

2.支付成功（仅限B2B网银支付）后广告服务平台查询实际付款人
根据平台自身实际需要，如果不接受付款人和合作客户不同的情况，平台可主动退款；若一致则可继续服务。

3.根据需要获取B2B支付业务的电子回单

4.根据实际需要，以企业客户的法人身份证+姓名发起资金出境（购汇或人民币出境）