建行相关App服务方接入文档v2.20_20250725

文档修订记录

文档目录

1. 接入说明

本文为服务方在建行相关App上接入H5生活场景的技术规范。

由于完成接入后的第三方生活场景将同时上架于多个建行相关App，服务方在对接技术规范时务必着重关注有关具体建行App的适配要求，逐一适配文档所列App。

2. 服务方跳转说明

2.1 跳转URL

建行相关App通过分类入口跳转或订单详情跳转至服务方链接时，使用URL格式为：

url?platform=ccblife&channel=mbs&ccbParamSJ=xxxxxx&CITYID=330100&USERCITYID =440100

其中：

url为服务方页面链接地址（一般为中间页面，用于对跳转参数的解密验签处理及二次跳转）;

platform=ccblife为建行生活平台标识符

channel为当前运行环境所在的App，如channel=mbs表示在中国建设银行App运行，如无此参数则默认为在建行生活App运行。

CITYID、USERCITYID为用户选择与定位城市代码，参考6位的中国城市代码，同密文参数一致

ccbParamSJ为使用服务方公钥RSA加密后再base64+encodeURIComponent的加密密文，其解密后明文为携带的用户信息，其格式为: USERID=&MOBILE=... (先进行URLDecode之后，再进行解密，解密方法同样参考《报文加密及签名》，略去签名步骤)

密文携带的基本参数如下：

2.2 建行相关App环境识别

服务方生活场景，按本章节方法识别当前运行的App环境是否为建行相关App。本章节所列App环境必须全部适配。

2.2.1 建行生活App环境判断

按如下顺序判断当前页面是否由建行生活App平台打开，满足其中任一条件即表示当前页面由建行生活App平台打开：

1）跳转url中包含platform=ccblife参数；

例：

url?platform=ccblife&channel=mbs&ccbParamSJ=xxxxxx&CITYID=330100&USERCITYID =440100

2）H5页面通过判断navigator.userAgent中含有CloudMercWebView字段 例：

Mozilla/5.0 (iPhone; CPU iPhone OS 14_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148/CloudMercWebView

3）使用以下方法获取userAgent，并判断含有“CloudMercWebView”：

window.CCBBridge.requestNative(JSON.stringify({
    action: "getUA",
    params: {}
}), "getUACallBackFund")

该js方法回调函数格式如下：

xxxxxxxxxx
getUACallBackFund("{
  data:{
      ua:'Mozilla/5.0 (iPhone; CPU iPhone OS 14_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148/CloudMercWebView'
  },
  state:0,
  msg:""
}")

2.2.2 中国建设银行App环境判断

当前跳转url中同时包含platform=ccblife以及channel=mbs两个参数，即表示当前在中国建设银行App环境。

例：

url?platform=ccblife&channel=mbs&ccbParamSJ=xxxxxx&CITYID=330100&USERCITYID =440100

2.3 加密串验证

为防止加密串被非法窃取导致的越权风险，建议服务方对加密串进行唯一请求校验。 例如以下请求串被抓包截取后，不校验即可能越权访问客户信息：

https://ccb.wenyu6.com/api/ccb/user?platform=ccblife&channel=mbs&ccbParamSJ=SnU1d0F6bkNCSUZhUFAvL0xpK3FVNml3OHptcDViTnFIR3RlQjlhWldUUlNJbWNXbytpR0VFNHdIeWFuWTdWdFl1VVFQaFBrV3R6WQptY3JldURGOGVyNmFiQ3N0TFgyYU1QeGsrZmxWUFJ3VEZGWmR4d084V0NCYlJyWGNnVXptMUQ1amVoT3hEZ0U1amM4OHF1MXdqd0I2ClVMV0t3bENmOEw1aGtEZUJsMk5Db04wQWxHVXBuRkMzRk9vWENHSUdNSHNNVVRmK2ZHUEFzTmFsR25SWkZiTmt1M0I0YkM2YkxCOTUKdWV3RG9ESVpTU2hHbUJOMFZ6U3Z5SFIzUWx0Umg5T3hQeU03UmFzTTRVQWllZTRBandRL1YyNURXeGZrOWdDRWRRWEx4d2pkOWUTVqTFg2dU8rRldJNzJEQmp2UT09Cg%3D%3D&CITYID=330100&USERCITYID=440100

可选校验方案如下：

1. 跳转访问时，记录手机号（或用户ID）标识此次访问是否有效，若为第一次访问则标识加密串已使用，重复访问则为非法请求。
2. 跳转访问时，解密后TIMESTAMP字段（跳转时间戳）与当前服务器时间偏差需在5分钟之内，否则为非法请求。

3. 建行相关App支付接入文档

如服务方生活场景涉及支付环节，必须按本章节要求完成文档所列建行相关App的支付接入，使用建行生活收银台完成支付。

如服务方生活场景不涉及支付环节，可略过本章节。

3.1 服务方调用收银台方法

本章节说明了如何调起建行生活收银台，如服务方生活场景涉及支付环节，必须按本章节要求完成文档所列建行相关App调起建行生活收银台适配。

3.1.1 在建行生活App环境收银台调用

由于平台的差异性，Android 与iOS需用定义的js方法来调用建行生活收银台，其中支付参数详见《商户下单支付参数》章节，以下为参考示例：
其中REMARK2填写服务方编号（服务方编号一般为以YS开头的16位编号）

(1) iPhone系统调用

xxxxxxxxxx
<script language="JavaScript">
/**
 * 调起收银台
 * @param {String} payInfo payInfo为支付参数（支付参数详见4.商户下单支付参数文档）
 */
function MBS_DIRECT_PAY(payInfo){
    window.location="mbspay://direct?"+ payInfo;
}
</script>

(2) Android系统调用

xxxxxxxxxx
<script language="JavaScript">
/**
 * 调起收银台
 * @param {String} payInfo payInfo为支付参数（支付参数详见4.商户下单支付参数文档）
 */
function MBS_DIRECT_PAY(payInfo){
    window.mbspay.directpay(payInfo); 
}
</script>
  

3.1.2 在中国建设银行App环境收银台调用

将支付参数组装后（含建行生活用户token，详见支付SDK《商户下单支付参数》文档），使用服务方公钥，参考《6.4.3 交易说明》、《6.4.4 加解密及签名方法》进行RSA加密，将密文、签名、服务方编号作为get请求参数，以html跳转的方式访问建行生活收银处理URL，由建行生活服务端统一处理并以302重定向方式返回建行生活收银台页面。

其中：

建行生活收银处理URL 通讯报文协议见《6.1 发送交易报文协议》“(2) 服务方前端与建行生活后台交易报文协议”。

3.2 支付成功页面回调设置

支付完成后默认跳转到建行生活的支付成功页面，如服务方需要跳转到自己的成功页，请调用setCache方法来设置。（setCache操作须在调起收银台（3.1.1 在建行生活App环境收银台调用）前进行）

​x
var requestObj  =  {
  action:'setCache',/*设置回调地址*/
  params:{
       key: '', // 回调的key，与下单参数的remark2保持一致，上送服务方编号
       value: '' // 回调的url，支付成功后将由建行生活收银台跳转至此url
  }
}
  
window.CCBBridge.requestNative(JSON.stringify(requestObj), 'callBackName'); 

// 注： callBackName是回调函数的名称（可自行定义），请先将回调函数挂载到window对象下；该回调仅作为地址设置成功的参考。

注：此设置方法仅在建行生活App环境有效，在中国建设银行App环境需在《商户下单支付参数》提供。

支付成功跳转后，设置的回调url会增加携带如下参数：

最终支付结果请以服务器通知为准

3.3 其他说明

• 建行相关App根据订单信息调起支付。
• 在支付模块完成支付后，点击完成支付，关闭支付模块，跳转到支付成功页面。
• 支付成功结果最终以服务器通知为准。

4. 商户下单支付参数文档

如服务方生活场景涉及支付环节，必须按本章节要求完成支付参数组装。

如服务方生活场景不涉及支付环节，可略过本章节。

4.1 商户->银行接口参数定义

注1：字符串中变量名必须是大写字母。
注2：是否非空指该字段是否为非空字段。Y表示上送该字段时，值不可为空；N表示值可以为空。 注3：是否必送指该字段是否上送。T表示该字段必须上送，无论是否有值；F表示字段可以不送。 注4：

• 标注特定场景使用的字段（灰色字体），请根据需要上送，非必要则无需上送；某些字段仅对特定服务方可用，其他服务方上送无效。
• 标注在中国建设银行App环境使用的字段（蓝色字体），仅在手机银行场景上送时生效，在建行生活APP内无效，无需上送。

4.2 MD5摘要签名（MAC校验）

采用标准MD5摘要算法对字符串数据签名（32位小写），得到MAC。 （注意和交易通讯报文的mac区分，签名时不需要额外拼接privateKey）

参与签名的字符串及其顺序如下（为上表中MAC字段之上的字段按顺序拼接）：

MERCHANTID=105910100194086&POSID=313368474&BRANCHID=441000000&ORDERID=202209020000000061&USER_ORDERID=202209020000000061&PAYMENT=22.39&CURCODE=01&TXCODE=520100&REMARK1=&REMARK2=YS44000098000600&TYPE=1&GATEWAY=0&CLIENTIP=&REGINFO=&PROINFO=&REFERER=&THIRDAPPINFO=comccbpay1234567890cloudmerchant&TIMEOUT=20220902103420&DCEP_MCT_TYPE=1&PLATFORMPUB=MIGfMA0GCSqGSIb......

注：黑色字体对应的字段必须参与MAC，橙色的字段请根据需要上送，且有值时才参与MAC，否则无需参与MAC

4.3 中文信息需要escape编码

使用js的escape()方法对REGINFO（客户注册信息）和PROINFO（商品信息）进行编码，数字字母信息不需编码。

例： escape(小飞侠) = %u5C0F%u98DE%u4FA0 escape(A1级牛排) = A1%u7EA7%u725B%u6392

4.4 商户公钥密文

ENCPUB: 各服务方使用自己的服务方公钥对商户公钥后30位进行RSA加密，再进行base64后，生成的密文串。

若商户已经上架建行生活并同步公钥，或是关联了外部平台商户号，可以不再上送商户公钥。

注：公钥加密方法见《建行生活输入通讯报文接口规范》的报文加密章节。

4.5 外部平台商户号说明

外部平台商户号用于服务方已在建行生活完成商户关联，且收款商户已上架建行生活，此时可以使用服务方关联的外部平台商户号来完成支付。 使用外部平台商户号后，原建行商户号、柜台号、分行号无需上送。 若不使用外部平台商户号，则必须上送建行商户号、柜台号、分行号。

4.6 扩展域说明

该字段仅提供给特定服务方场景使用，内容为双方约定值，格式为JSON字符串，上送时需要encodeURI编码。 例： 善融积分：

xxxxxxxxxx
{
    "scene": "pointPay", // 场景
    "pointAmount": "1.50", // 积分金额
    "pointNum": "1050"  // 积分数量
}

扩展域列表

4.7 PAYBITMAP和ACCOUNTBITMAP说明

PAYBITMAP和ACCOUNTBITMAP分别为定长10位数字的位图，位图为1表示可用，为0表示不可用。两个字段可单独使用，未上送时默认全部支付方式都支持，即全为1（1111111111）。

PAYBITMAP：支付方式位图。第一位生活钱包支付，第二位龙支付，第三位微信支付，第四位数币支付，第五位信用付，第六位快贷支付，其余位图保留。 ACCOUNTBITMAP：支付账户位图，仅对龙支付及生活钱包下的卡账户生效。第一位建行借记卡，第二位建行贷记卡，第三位他行借记卡，第四位为他行贷记卡，第五位为建行钱包，其余位图保留。

注：该位图字段在判断支付方式是否可用时优先级最低，仅当商户已支持某一种支付方式时，服务方可对其决定是否使用。例如商户不支持微信支付，即使位图上送1也不会生效。

4.8 ORDERID和USER_ORDERID说明

ORDERID：商户发起支付的流水号，用于建行收单支付流程，包括在支付、查询支付结果及退款交易中使用。 USER_ORDERID：用户订单号，用于同步用户在建行生活中的订单状态，包括在订单推送及状态更新时使用。

• 通常情况下，若服务方对订单号没有特殊要求，ORDERID与USER_ORDERID可以保持一致；
• 考虑到存在一笔订单用户会多次发起支付的情况，若服务方对同一笔订单每次发起支付的流水号要求不一样，可以使用同一USER_ORDERID（订单号）对应不同ORDERID（流水号）来区分每笔支付交易。

4.9 最终参数串示例

参与验签字符串+MD5码+服务方编号+商户公钥密文

MERCHANTID=105910100194086&POSID=313368474&BRANCHID=441000000&ORDERID=202209020000000061&USER_ORDERID=202209020000000061&PAYMENT=22.39&CURCODE=01&TXCODE=520100&REMARK1=&REMARK2=YS44000098000600&TYPE=1&GATEWAY=0&CLIENTIP=&REGINFO=&PROINFO=&REFERER=&THIRDAPPINFO=comccbpay1234567890cloudmerchant&TIMEOUT=20220902103420&DCEP_MCT_TYPE=1&MAC=f07ef63236e3bbbc1dc221b06e631f3d&PLATFORMID=YS44000098000600&ENCPUB=YzNxRGtKSkFYZURRczYvNDN6WVZkYk......

详细信息可参考《支付下单串示例.xlsx》文件

5. 基本交易流程说明

5.1 业务流程图

以建行生活App环境为例仅供参考

重点步骤说明： 步骤2：由服务方调用订单推送接口（A3341O031）向建行生活推送订单信息 步骤3：参考《建行相关App支付接入文档》调用收银台 步骤10、11：支付通知有两种推送方式，具体细节参考《建行生活支付通知接口》：

• 方式1：网银通知建行生活，再由建行生活转发给服务方
• 方式2：网银直接通知服务方

步骤13、16：由服务方调用订单更新接口（A3341O033）向建行生活更新订单状态。 步骤14、15：服务方可以向外联平台主动查询订单交易流水，判断订单的支付状态。外联平台接入请参考“外联接口（网银）”（或使用A3341O035）

6. 建行生活输入通讯报文接口规范

6.1 发送交易报文协议

(1) 服务方后台与建行生活后台交易报文协议

建行生活后端交易采用HTTP Post 方式为对外通信协议。 访问地址示例：

http://ip:port(域名)/standardxml_adapter/standardxmlchannelservlet

调用HTTP Post方法： HTTP消息体内传输协议报文头、应用报文。

建行生活后端新系统通讯地址（A3341XXXX）：

(2) 服务方前端与建行生活后台交易报文协议

此方式仅适用于在中国建设银行App环境。前端以页面跳转的方式访问建行生活收银处理URL。

访问地址格式：

url?txcode=A3341OM01&svcid=aaaaaaaaa&cnt=xxxxxx&mac=yyyyyyy

其中：

txcode收银处理交易码，固定为A3341OM01

svcid为YS开头的服务方编号。

cnt为将支付参数组装后（含建行生活用户token，详见支付SDK《商户下单支付参数》文档），用建行生活公钥进行加密后的RSA密文参数。

mac为MD5签名，32位大写（注意与支付参数的MAC区分）

加解密及签名详见《6.4.3 交易说明》、《6.4.4 加解密及签名方法》

url地址（仅A3341OM01）：

6.2 报文规范

6.2.1 交易请求报文格式

请求报文由两部分组成，交易请求报文头和交易请求报文体。其中交易请求报文头信息在报文头（CLD_HEADER）节点内，交易请求报文体信息在报文体（CLD_BODY）节点内。

请求报文头字段说明：

请求报文体信息

根据交易报文接口章节中每个交易的请求接口定义组装请求报文。

请求报文样例：

xxxxxxxxxx
{
    "CLD_HEADER":{
        "CLD_TX_CHNL":"YSTEST",
        "CLD_TX_TIME":"20241231090000",
        "CLD_TX_CODE":"A3341O031",
        "CLD_TX_SEQ":"1010114131620897033814262"
    },
    "CLD_BODY":{

    }
}

6.2.2 交易应答报文规范

应答报文由两部分组成，交易应答报文头和交易应答报文体。其中交易应答报文头信息在报文头（CLD_HEADER）节点内，交易应答报文体信息在报文体（CLD_BODY）节点内。

应答报文头字段说明：

应答报文体信息

根据交易报文接口章节中每个交易的应答接口定义组装应答报文。

应答报文样例：

xxxxxxxxxx
{
    "CLD_HEADER":{
        "CLD_TX_CHNL":"",
        "CLD_TX_TIME":"20151231090000",
        "CLD_TX_CODE":"A3341O031",
        "CLD_TX_SEQ":"1010114131620897033914221",
        "CLD_TX_RESP":{
            "CLD_CODE":"",
            "CLD_DESC":""
        }
    },
    "CLD_BODY":{

    }
}

6.2.3 报文编码说明

报文使用UTF-8编码

6.2.4 报文长度说明

非二进制类型报元单个报元长度建议在9999位以内，整体报文大小建议在20K以内；考虑到客户登录类交易如果账户数量较多的情况，登录类交易可以在2M以内；

6.2.5 报文结构及数据类型

对交易报文接口章节中的字段进行说明

报文结构

• 数组

xxxxxxxxxx
{
    "ADDR_LIST":[
        "张杨路500号14楼"
    ]
}

• 结构 一个标签中还有子标签，此标签没有重名的标签，就代表一个结构，属性p_type="G"代表是一个复合类型。

xxxxxxxxxx
{
    "SCI35022_0":{
        "ADDR":"张杨路500号14楼",
        "ADDR_TYP":"OFF",
        "POSTCOD_TYP":"200122",
        "TEL_NO":"13601735604"
    }
}

• 结构数组

xxxxxxxxxx
{
    "SCI_LIST":[
        {
            "ADDR":"张杨路500号14楼",
            "ADDR_TYP":"OFF",
            "POSTCOD_TYP":"200122",
            "TEL_NO":"13601735604"
        },
        {
            "ADDR":"张杨路500号14楼",
            "ADDR_TYP":"OFF",
            "POSTCOD_TYP":"200123",
            "TEL_NO":"13601735605"
        }
    ]
}

6.2.6 数据类型

数据类型分为B、C、N、codestring。B为字节数组、C为字符串，N为数值型（长度、小数位），codestring为分类代码。它们在XML中都是以字符串存储的，B类型用Base64编码后存储。C类型非法字符以存储。

6.3 服务接口定义

详见接口定义文档《建行生活输入通讯报文》（.xlsx）（在附件中获取）

6.4 报文加密及签名

6.4.1 流程说明

1. 服务方与建行生活后端通讯是通过JSON密文进行，例子如下：

xxxxxxxxxx
{
    "svcid": "服务方ID，以YS开头",
    "cnt": "密文xxxx",
    "mac": "签名yyyy"
}

2. 当前置解密失败或验签失败时，建行生活无法识别进来系统的信息，无法正常处理，则会直接返回JSON错误报文（当加密失败时，同样走此路径）

xxxxxxxxxx
{
    "code": "错误码xxxx",
    "msg": "错误描述yyyy"
}

3. 当前置解密+验签成功时，说明可以确认对应的密钥信息，后续业务处理后，无论是否发生异常，都根据加密加签标准返回报文，如下

xxxxxxxxxx
{
    "cnt": "密文xxxx",
    "mac": "签名yyyy"
}

6.4.2 报文样例

原始报文：

xxxxxxxxxx
{
    "CLD_HEADER":{
        "CLD_TX_CHNL":"YSTEST",
        "CLD_TX_TIME":"20191112145911",
        "CLD_TX_CODE":"A3341O031",
        "CLD_TX_SEQ":""
    },
    "CLD_BODY":{
        "USER_ID":"user123",
        "ORDER_ID":"order123",
        "ORDER_DT":"20191112145811",
        "TOTAL_AMT":"100.00",
        "PAY_AMT":"90.00",
        "DISCOUNT_AMT":"10.00",
        "ORDER_STATUS":"1",
        "REFUND_STATUS":"0",
        "MCT_NM":"XXX商户"
    }
}

加密后报文：

xxxxxxxxxx
{
    "cnt":"UWl3VVVIT0IzSHp6VUtpNFVmb25VcWJjMnBKdU9IclJUZ3lISGJLR3Myd21saWQvMTVvenNMNk5xWmFwUzl1clh5K2VkVmJuU1BYMg0KTzUwamNkZWRmdjc5NHdDRmJSdjF4WDl4bzAwejMwU2k2NXJ6cTVaVVU4dUt2ZmNPeVJ1cDJkTC9SOUgvODVUblNLbEVXUnErSGo3dw0KMzB2YjFaeU1acU5iRVZnb25VSTUrcmlPV2wweWUwb2xQTVFoei9CVWhDcU9qOExqR21hTDBCdGpVbVdiTyttU3Vpa0s5Y25md3g0SQ0KV0xUSk1BWjl3OHdkZ0FqamI5bXhJbFJUM3JrU3VId1RMdGF0VkdJcGovVDAvdk5nQzNUcWgvODJOQnZvYXdoYnl0Z3AwRW9FNWp5bw0KdVhmYVZDZE9IeGp4ZkpyclFFSCt5THFoZXl2MEx2OGJ1b0x0N0pYMi9zM0pJS0J1bFdSZWJHRTMrcmpEMm9sUVJiYklONkdpeDlodQ0KUEprWkFkK0UrcTV1ZFR4OXpFRlJyWVBHVURzL0RLK0JFSk5iYWZGRnllZTBrRzh2YVlmU1NxeFBWcVBrblRzZ2oxdXFqME0xTGFCNQ0KZ1drVU9vVnl4bUtXUEpYd3JqYXlkSUxVeEZ2dkwzZEpHYmV6cnUwK3d1V3A2QXBQVnRkOElaSm4NCg==",
    "mac":"1659E42FC9D2A2186228C4607A566D78",
    "svcid":"YSTEST"
}

6.4.3 交易说明

服务方主动调用建行生活的接口时，需传递的是服务方编号（由建行生活分配）、RSA密文及签名三个数据。

• RSA密文 是基于RSA对全报文加密，公私钥在系统外相互同步（如，文本文档，在行内通讯软件传输），上文中显示的报文是加密前或解密后的报文格式。
• 签名 是针对源报文（未加密）+私钥获取MD5的数据，验签需要接收方先解密密文，获得源报文后自行拼接私钥获取MD5，再验证与接收的MD5签名是否一致，不一致则为报文篡改，不对报文进行处理，直接结束返回异常提示。
• 密文 使用cnt字段传输，签名使用mac传输，所以加密及签名后，实际传输的内容只有svcid=aaaaaaaaa&cnt=xxxxxx&mac=yyyyyyy（aaaaaaaaa 为服务方编号，xxxxxx为密文内容，yyyyyyy为签名内容）

6.4.4 加解密及签名方法

本章节提供两个文件MD5Util.java、RSAUtil.java及加解密方法 (对应文件可在附件中获取)

1. MD5Util.java
2. RSAUtil.java

3. 加解密方法参考示例

xxxxxxxxxx
// 公钥
String publicKey = "";

// 私钥
String privateKey = "";

/**
 * 加密及获取签名
 */
// 源报文(未加密)
String msg = "";

// 公钥加密得到密文并使用base64处理
String enc_msg = RSAUtil.encrypt(msg, publicKey);
BASE64Encoder encoder = new BASE64Encoder();
enc_msg = encoder.encode(enc_msg.getBytes("UTF-8"));
enc_msg = enc_msg.replaceAll("\r\n", "").replaceAll("\r", "").replaceAll("\n", "");

// 根据源报文+私钥获得MD5签名
String mac_info = MD5Util.getMD5(msg + privateKey);


/**
 * 解密及验签
 */
// base64逆处理并用私钥解密
BASE64Decoder decoder = new BASE64Decoder();
enc_msg = new String(decoder.decodeBuffer(enc_msg),"UTF-8");
String dec_msg = RSAUtil.decrypt(enc_msg, privateKey);

// 验签
String dec_mac = MD5Util.getMD5(dec_msg + privateKey);
if (mac_info.equals(dec_mac)) {
    System.out.println("验签通过");
} else {
    System.out.println("验签失败");
}

提示：如果使用的JDK版本高于1.8，请将base64方法由sun.misc.BASE64Encoder替换为java.util.Base64,即 加密方法：

xxxxxxxxxx
// BASE64Encoder encoder = new BASE64Encoder();
// enc_msg = encoder.encode(enc_msg.getBytes("UTF-8"));
// 替换为
Encoder encoder = Base64.getEncoder();
enc_msg = encoder.encodeToString(enc_msg.getBytes("UTF-8"));

// RSAUtil.java: (new BASE64Encoder()).encodeBuffer(key) 替换为
Base64.getEncoder().encodeToString(key)

解密方法：

xxxxxxxxxx
// BASE64Decoder decoder = new BASE64Decoder();
// enc_msg = new String(decoder.decodeBuffer(enc_msg), "UTF-8");
// 替换为
Decoder decoder = Base64.getMimeDecoder();
enc_msg = new String(decoder.decode(enc_msg), "UTF-8");

// RSAUtil.java: (new BASE64Decoder()).decodeBuffer(key) 替换为
Base64.getMimeDecoder().decode(key)

7. 建行生活支付通知接口

如服务方生活场景涉及支付环节，必须按本章节要求完成支付回调通知对接。 同时，因网络问题存在支付通知丢失的可能性，请服务方考虑通过主动查询支付流水的方式作为兜底，参考《建行生活输入通讯报文》服务方订单查询交易。

如服务方生活场景不涉及支付环节，可略过本章节。

支付结果推送接口是特殊接口，属于建行生活主动推送给服务方，所以不会附带服务方编号。 服务方接收支付通知的系统地址，需要配置在建行生活运营后台，请联系运维进行配置。

接口推送报文示例

xxxxxxxxxx
{"ACC_TYPE": "WX","BRANCHID": "310000000","CCB_DISCOUNT_AMT": "","CCB_DISCOUNT_AMT_DESC": "","CLIENTIP": "11.123.44.55","CURCODE": "01","MRCH_ID": "","NT_TYPE": "YS","ORDERID": "210520133844test3yhv","PAYMENT": "0.01","PAY_TYPE": "01","POSID": "123442025","REFERER": "","REMARK1": "","REMARK2": "YS1234009000111**WXZF","SIGN":"1a4aca34f02c0efab014ff823153a2a07a35a8a8410591a992d4aa9cd7fa1f961b952236a45b4fe37867ad4a7214ecbeae21957dee9c19d3d2f5dcf09c8faca81ceb68119c8dcd53bd1e70c23f60fc03e7cd96b8c0082a1243d688c13aac0bcd9e177c559e40e782e3856ada32de8d8ce0054e35fca2022b8f91b2a1ca2c5e10","SUCCESS": "Y","TYPE": "1"}

发起支付时（调用商户下单支付接口），把服务方编号通过REMARK2字段送到支付渠道，让支付渠道再推送结果给建行生活时，建行生活根据该字段来判断订单归属哪个服务方，然后指定推送订单结果给对应的服务方（需要在后台维护服务方系统地址）。

PS: 由建行生活推送给服务方的支付通知会额外携带该笔订单所使用的优惠金额；但是由网银直接推送的支付通知，只含原订单金额，不包含优惠金额，需要服务方自行向外联平台查询。

7.1 背景描述

目前对于支付后通知，根据支付方式的不同，有两种通知路径：

• 对于路径1，按照原来的方式保持不变，由建行网银直接通知到各场景服务方。路径1使用的公钥为商户服务平台下载的对应柜台公钥。
• 对于路径2，建行生活收到网银发送的支付通知之后，主动向各场景服务方转发该通知。涉及推送的服务方通知地址，需由场景服务方提供到建行生活运营人员，由建行生活运营人员在后台进行配置。路径2使用的公钥为建行生活专门为场景服务方分配的用于支付通知的公钥（请联系建行生活平台获取）。
• 对于钱包支付、龙支付使用的通知路径，根据商户服务平台配置的服务器反馈地址决定。反馈地址设置服务方系统地址，通知走路径1；反馈地址设置建行生活地址，通知走路径2。

7.2 字段描述

注1：除不参与签名的字段外，加粗字段为验签时必输字段，其余字段请判断在当且仅当该字段返回时参与验签 注2：需要使用服务方公钥解密的字段，仅当由建行生活转发支付通知时会存在

7.2.1 USRINFO字段说明

7.2.2 USRMSG字段说明

使用对称加密算法对“户名|账号”进行加密后通过商户通知接口传送到商户系统，对称加密的密钥为建行生活为场景服务方分配的专门用于支付通知的公钥后30位【注意区别于在商户服务平台下载的柜台公钥】。如：

密钥：f6528d5c335b7092fc9ec1b3020111 原串：梅九六|6214662020019275 加密串：AWWo2KKeATj6XxRglo7uaR0yZ2QQtCW%2C 使用MCipherDecode.java类中的getDecodeString(String urlString)方法进行解密，主要步骤如下：

xxxxxxxxxx
MCipherDecode mcd = new MCipherDecode(key);// 设置密钥
decodedString = mcd.getDecodeString(cipherdURL);// 解密
byte[] tempByte = decodedString.getBytes("ISO-8859-1"); 
String a = new String(tempByte,"GBK"); // 进行字符转码

系统编码为ISO-8859-1，商户处理时请注意编码问题。

1）支付详细信息字段说明

i. 支付宝的支付渠道说明（后续可能增加，请注意兼容）

ii. 建行的支付渠道说明（后续可能增加，请注意兼容）

商户通知串格式

请注意 TYPE、 REFERER 、 CLIENTIP 、 ACCDATE、 INSTALLNUM、 ERRMSG、USRMSG、USRINFO、DISCOUNT、ZHJF、OPENID、SUB_OPENID、 PAYMENT_DETAILS 只有在满足条件的情况下才会返回。

商户通知串样例：

POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1=&REMARK2=&ACC_TYPE=12&SUCCESS=Y&TYPE=1&REFERER=http://www.ccb.com/index.jsp&CLIENTIP=172.0.0.1&ACCDATE=20100907&INSTALLNUM=3&ERRMSG=&USRMSG=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D&USRINFO=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D&DISCOUNT=0.01&ZHJF={“APnt_Hpn_Num”:”积分发生数量”,”APntCmpt_Amt”:”积 分 抵 扣 金 额 ”}&OPENID=oUpF8uChLsBIhscta2jEtNGam5sI&SUB_OPENID=oZQ9N5fxh-dig4CtC_cNxTIZ68ZA&PAYMENT_DETAILS=%7B%22TYPE%22%3A%22ALIPAY%22%2C%22PAY_CHANNEL%22%3A%22BANKCARD%22%2C%22DEBIT_CREDIT_TYPE%22%3A%22DEBIT_CARD%22%2C%22THIRD_TRADE_NO%22%3A%222018010521001004890523646975%22%7D&SIGN=317b7dd349c1fbcabc26a20ba117a778da5a685c588be5e7378682651062a25b0885e36ee237c19a143f7271c9529a0e9bf198c8735709dc74233d96e1a276cec9d4835422bee597100b0a47d11b44dbba74bdf9cbde0587f138141ce79a3536733d5f6b53ed119c13708dca52ee8d3fcf7e67dcdb20053889adff1989a8c859

签名运算原串

请注意：红色字体对应的字段必须参与签名；其他字段在商户通知串中有返回时（无论值是否为空），需参与签名，否则无需参与签名。

参与签名运算的字符串及其顺序如下：

POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1=&REMARK2=&ACC_TYPE=12&SUCCESS=Y&TYPE=1&REFERER=http://www.ccb.com/index.jsp&CLIENTIP=172.0.0.1&ACCDATE=20100907&INSTALLNUM=3&ERRMSG=&USRMSG=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D&USRINFO=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D&DISCOUNT=0.01&ZHJF={“APnt_Hpn_Num”:”积分发生数量”,”APntCmpt_Amt”:”积 分 抵 扣 金 额 ”}&OPENID=oUpF8uChLsBIhscta2jEtNGam5sI&SUB_OPENID=oZQ9N5fxh-dig4CtC_cNxTIZ68ZA&PAYMENT_DETAILS=%7B%22TYPE%22%3A%22ALIPAY%22%2C%22PAY_CHANNEL%22%3A%22BANKCARD%22%2C%22DEBIT_CREDIT_TYPE%22%3A%22DEBIT_CARD%22%2C%22THIRD_TRADE_NO%22%3A%222018010521001004890523646975%22%7D

注：字符串中变量名必须是大写字母。

7.2.3 SIGN字段说明

1. 商户通知串的格式如下：

例1：

NT_TYPE=YS&PAY_TYPE=01&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1=&REMARK2=&ACC_TYPE=12&SUCCESS=Y&TYPE=1&REFERER=http://www.ccb.com/index.jsp&CLIENTIP=172.0.0.1&ACCDATE=20100907&USRMSG=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D&INSTALLNUM=3&ERRMSG=&USRINFO=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D&SIGN=317b7dd349c1fbcabc26a20ba117a778da5a685c588be5e7378682651062a25b0885e36ee237c19a143f7271c9529a0e9bf198c8735709dc74233d96e1a276cec9d4835422bee597100b0a47d11b44dbba74bdf9cbde0587f138141ce79a3536733d5f6b53ed119c13708dca52ee8d3fcf7e67dcdb20053889adff1989a8c859

例2：

PAYMENT=0.01&POSID=045242025&SUCCESS=Y&PAY_TYPE=01&CCB_DISCOUNT_AMT_DESC=&REMARK1=&REMARK2=YS44000009000152**WXZF&NT_TYPE=YS&MRCH_ID=&ORDERID=210520133844test3yhv&REFERER=&CLIENTIP=11.168.99.30&SIGN=1a4aca34f02c0efab014ff823153a2a07a35a8a8410591a992d4aa9cd7fa1f961b952236a45b4fe37867ad4a7214ecbeae21957dee9c19d3d2f5dcf09c8faca81ceb68119c8dcd53bd1e70c23f60fc03e7cd96b8c0082a1243d688c13aac0bcd9e177c559e40e782e3856ada32de8d8ce0054e35fca2022b8f91b2a1ca2c5e10&ACC_TYPE=WX&CCB_DISCOUNT_AMT=&CURCODE=01&TYPE=1&BRANCHID=310000000

请注意ACC_TYPE、ACCDATE、USRMSG、INSTALLNUM、ERRMSG、USRINFO只有在满足条件的情况下才会返回。 字符串中变量名必须是大写字母。

2. 获取待签名数据，待签名数据中的字段顺序请参考上述的字段域，字段是否参与签名及顺序请参考字段描述

例1：

POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1=&REMARK2=&ACC_TYPE=12&SUCCESS=Y&TYPE=1&REFERER=http://www.ccb.com/index.jsp&CLIENTIP=172.0.0.1&ACCDATE=20100907&USRMSG=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D&INSTALLNUM=3&ERRMSG=&USRINFO=T4NJx%2FVgocRsLyQnrMZLyuQQkFzMAxQjdqyzf6pM%2Fcg%3D

例2：

POSID=045242025&BRANCHID=310000000&ORDERID=210520133844test3yhv&PAYMENT=0.01&CURCODE=01&REMARK1=&REMARK2=YS44000009000152**WXZF&ACC_TYPE=WX&SUCCESS=Y&TYPE=1&REFERER=&CLIENTIP=11.168.99.30

3. 获取数字签名域，即 SIGN 字段值，如：

317b7dd349c1fbcabc26a20ba117a778da5a685c588be5e7378682651062a25b0885e36ee237c19a143f7271c9529a0e9bf198c8735709dc74233d96e1a276cec9d4835422bee597100b0a47d11b44dbba74bdf9cbde0587f138141ce79a3536733d5f6b53ed119c13708dca52ee8d3fcf7e67dcdb20053889adff1989a8c859

4. 将上面步骤中的值，传入验签方法进行验证。 4.1 将netpay.jar引用至java开发工程中。（netpay.jar可在附件文件夹中获取） 4.2 CCBSign.RSASig是签名包的封装类,验签时使用此类即可：

xxxxxxxxxx
/**
* Method: setPublicKey
* description: 设置验签用公钥
* 
* @param pkey
*            商户的公钥
* @return 无
*/
setPublicKey(String pkey)


/**
* Method: verifySigature
* description: 验证签名
* 
* @param sign
*            建行返回的sign签名
* @param src
*            签名前的源串，例如：POSID=000000&BRANCHID=110000000&ORDERID=00320995&PAYMENT=0.01&CURCODE=01&REMARK1=test1&REMARK2=test2&SUCCESS=Y
* @return true-验证通过 false-验证失败
*/
boolean verifySigature(String sign,String src)

注：

• 当NT_TYPE=YS时，使用建行生活分配的服务商支付验签公钥转换后进行验签 （注意与服务方公私钥相区分）
• 当NT_TYPE=CCB时，使用商户服务平台下载的商户公钥进行验签

7.2.4 CCB_DISCOUNT_AMT和CCB_DISCOUNT_AMT_DESC字段说明

这两个字段为加密字段，加密方式 RSAUtil.encrypt->BASE64Encoder(UTF-8,并处理换行)【即建行生活接口的加密方式】。 CCB_DISCOUNT_AMT为在建行网关支付产生的优惠总额，商户可以根据（订单金额 - 优惠总额）得到实付金额 CCB_DISCOUNT_AMT_DESC为优惠明细，格式为：优惠名称=优惠金额|@|优惠名称=优惠金额 （多种优惠以|@|分隔）

7.2.5 MRCH_ID字段说明

该字段为加密字段，加密方式 RSAUtil.encrypt->BASE64Encoder(UTF-8,并处理换行)【即建行生活接口的加密方式】。

7.2.5 CRCRD_INSTM_PRD_NUM和BIGAMT_INSTM_HDCG字段说明

当商户使用商户侧分期支付时，额外返回这两个相关字段。 该字段为加密字段，加密方式 RSAUtil.encrypt->BASE64Encoder(UTF-8,并处理换行)【即建行生活接口的加密方式】。

8. 建行生活退款操作通知接口(不能用于退款结果判断)

如服务方场景需要接收退款操作消息通知，必须按本章节要求完成退款回调通知对接。 不同于支付结果推送，退款操作消息推送仅推送商户号、订单号等少量用于查询使用的信息，若需获知退款状态、金额、优惠信息和支付方式等信息，参考《建行生活输入通讯报文》服务方订单查询交易（A3341TP03）。

如服务方场景不涉及退款环节或仅通过A3341TP04服务方退款交易完成退款，已实现退款流程的闭环，可略过本章节。

订单退款操作消息推送属于建行生活主动推送给服务方，所以不会附带服务方编号。 服务方接收退款操作消息通知的回调地址，需要配置在建行生活运营后台，请联系运维进行配置。

接口推送报文示例

xxxxxxxxxx
{"MRCH_ID": "1050000000000000000","NT_TYPE": "YS","ORDERID": "210520133844test3yhv","REFUND_DTM": "20250601120000", "SIGN" : "317b7dd349c1fbcabc26a20ba117a778da5a685c588be5e7378682651062a25b0885e36ee237c19a143f7271c9529a0e9bf198c8735709dc74233d96e1a276cec9d4835422bee597100b0a47d11b44dbba74bdf9cbde0587f138141ce79a3536733d5f6b53ed119c13708dca52ee8d3fcf7e67dcdb20053889adff1989a8c859"}

8.1 背景描述

对于服务方已支付成功的订单，存在商户直接去商户服务平台退款的情况，此时服务方无法获悉退款操作。 可能导致服务方订单状态与实际不一致以及用户在服务方场景权益未退回等情况。 建行生活支持将服务方下单场景商户的退款操作消息通知给服务方， 服务方可基于该消息去查询A3341TP03（服务方订单查询）接口判断用户是否发生了退款以及退款金额等信息， 并推送正确的订单状态，使整个交易链路闭环，确保订单状态的一致性。

8.2 字段描述

注：除不参与签名的字段外，加粗字段为验签时必输字段

签名运算原串

参与签名运算的字符串及其顺序如下：

ORDERID=210520133844test3yhv&MRCH_ID=1050000000000000000&REFUND_DTM=20250601120000

注：字符串中变量名必须是大写字母。

8.2.1 SIGN字段说明

1. 获取待签名数据，待签名数据中的字段顺序请参考上述的字段域，字段是否参与签名及顺序请参考字段描述

例1：

xxxxxxxxxx
{"MRCH_ID": "","NT_TYPE": "YS","ORDERID": "210520133844test3yhv","POSID": "123442025","SUCCESS": "Y", "SIGN" : "317b7dd349c1fbcabc26a20ba117a778da5a685c588be5e7378682651062a25b0885e36ee237c19a143f7271c9529a0e9bf198c8735709dc74233d96e1a276cec9d4835422bee597100b0a47d11b44dbba74bdf9cbde0587f138141ce79a3536733d5f6b53ed119c13708dca52ee8d3fcf7e67dcdb20053889adff1989a8c859"}

ORDERID=210520133844test3yhv&MRCH_ID=&REFUND_DTM=20250601120000

例2：

xxxxxxxxxx
{"MRCH_ID": "1050000000000000000","NT_TYPE": "YS","ORDERID": "210520133844test3yhv","REFUND_DTM": "20250601120000", "SIGN" : "317b7dd349c1fbcabc26a20ba117a778da5a685c588be5e7378682651062a25b0885e36ee237c19a143f7271c9529a0e9bf198c8735709dc74233d96e1a276cec9d4835422bee597100b0a47d11b44dbba74bdf9cbde0587f138141ce79a3536733d5f6b53ed119c13708dca52ee8d3fcf7e67dcdb20053889adff1989a8c859"}

ORDERID=210520133844test3yhv&MRCH_ID=1050000000000000000&REFUND_DTM=20250601120000

2. 获取数字签名域，即 SIGN 字段值，如：

317b7dd349c1fbcabc26a20ba117a778da5a685c588be5e7378682651062a25b0885e36ee237c19a143f7271c9529a0e9bf198c8735709dc74233d96e1a276cec9d4835422bee597100b0a47d11b44dbba74bdf9cbde0587f138141ce79a3536733d5f6b53ed119c13708dca52ee8d3fcf7e67dcdb20053889adff1989a8c859

3. 验签方法参照SIGN字段说明第4点

9. 附录

9.1 响应字典

9.2 交易流水标识

行外服务方： 使用具有唯一性的交易流水号即可，不要求编码方式 行内服务方： 流水号(全局事件跟踪号)，采用4段28位编码方式，如下图所示：

• 第一段：长度为6位，渠道代号，由建行生活为各接入通讯渠道分配
• 第二段：长度为2位，通讯渠道方为发送机器进行编号定义
• 第三段：长度为14位，是纯数字的时间标签，精确到秒，格式为yyyyMMddHHmmss，即假设当前时间为2019-2-23 15:47:26，那标签为20190223154726。
• 第四段：长度为6位，为序列号，由机器自身的序列号生成器产生，从0开始递增，每取出一个序列号后即向上加1，直至到达999999之后循环从0重复开始。序列号应该与时间是不相关的，禁止到达某一时间点即对序列号清零，因为机器的系统时间会被手动调整或自动同步而可能出现相同的时间。

9.3 拓展域列表

善融积分：

xxxxxxxxxx
{
    "scene": "pointPay", // 场景
    "pointAmount": "1.50", // 积分金额
    "pointNum": "1050"  // 积分数量
}

限卡支付：

xxxxxxxxxx
{
    "scene": "uniqueCardPay", // 场景
    "cardNo": "6210123456784321", // 银行卡号
}

9.4 文件参考

1. MD5Util.java

xxxxxxxxxx

import java.security.MessageDigest;

public class MD5Util {

    // 生成MD5
    public static String getMD5(String message) throws Exception {
        String md5 = "";
        MessageDigest md = MessageDigest.getInstance("MD5"); // 创建一个md5算法对象
        byte[] messageByte = message.getBytes("UTF-8");
        byte[] md5Byte = md.digest(messageByte); // 获得MD5字节数组,16*8=128位
        md5 = bytesToHex(md5Byte); // 转换为16进制字符串
        return md5;
    }

    // 二进制转十六进制
    private static String bytesToHex(byte[] bytes) throws Exception {
        StringBuffer hexStr = new StringBuffer();
        int num;
        for (int i = 0; i < bytes.length; i++) {
            num = bytes[i];
            if (num < 0) {
                num += 256;
            }
            if (num < 16) {
                hexStr.append("0");
            }
            hexStr.append(Integer.toHexString(num));
        }
        return hexStr.toString().toUpperCase();
    }
}

2. RSAUtil.java

xxxxxxxxxx

import java.io.ByteArrayOutputStream;
import java.security.Key;
import java.security.KeyFactory;
import java.security.spec.PKCS8EncodedKeySpec;
import java.security.spec.X509EncodedKeySpec;
import javax.crypto.Cipher;

import sun.misc.BASE64Decoder;
import sun.misc.BASE64Encoder;

public class RSAUtil {

    /**
     * 加密算法RSA
     */
    private static final String KEY_ALGORITHM = "RSA";

    /**
     * RSA最大加密明文大小
     */
    private static final int MAX_ENCRYPT_BLOCK = 117;

    /**
     * RSA最大解密密文大小
     */
    private static final int MAX_DECRYPT_BLOCK = 128;

    /**
     * Method: decryptBASE64 
     * description: 解码返回byte 
     * 
     * @param key
     * @return
     * @throws Exception
     */
    public static byte[] decryptBASE64(String key) throws Exception {
        return (new BASE64Decoder()).decodeBuffer(key);
    }

    /**
     * Method: encryptBASE64 
     * description: 编码返回字符串 
     * 
     * @param key
     * @return
     * @throws Exception
     */
    public static String encryptBASE64(byte[] key) throws Exception {
        return (new BASE64Encoder()).encodeBuffer(key);
    }

    /**
     * 获取base64加密后的字符串的原始公钥
     * 
     * @param keyStr
     * @return
     * @throws Exception
     */
    public static Key getPublicKeyFromBase64KeyEncodeStr(String keyStr) throws Exception {
        byte[] keyBytes = decryptBASE64(keyStr);
        // 取得公钥
        X509EncodedKeySpec x509KeySpec = new X509EncodedKeySpec(keyBytes);
        Key publicKey = KeyFactory.getInstance(KEY_ALGORITHM).generatePublic(x509KeySpec);
        return publicKey;
    }

    /**
     * 获取base64加密后的字符串的原始私钥
     * 
     * @param keyStr
     * @return
     * @throws Exception
     */
    public static Key getPrivateKeyFromBase64KeyEncodeStr(String keyStr) throws Exception {
        byte[] keyBytes = decryptBASE64(keyStr);
        // 取得私钥
        PKCS8EncodedKeySpec pkcs8KeySpec = new PKCS8EncodedKeySpec(keyBytes);
        Key privateKey = KeyFactory.getInstance(KEY_ALGORITHM).generatePrivate(pkcs8KeySpec);
        return privateKey;
    }

    /**
     * Method: encrypt 
     * description: 公钥分段加密 
     * 
     * @param dataStr
     *            加密内容，明文
     * @param publicKeyStr
     *            公钥内容
     * @return 密文
     * @throws Exception
     */
    public static String encrypt(String dataStr, String publicKeyStr) throws Exception {
        System.out.println("公钥分段加密开始");
        ByteArrayOutputStream out = null;
        String encodedDataStr = null;
        try {
            out = new ByteArrayOutputStream();
            byte[] data = dataStr.getBytes("utf-8");
            // 获取原始公钥
            Key decodePublicKey = getPublicKeyFromBase64KeyEncodeStr(publicKeyStr);
            KeyFactory keyFactory = KeyFactory.getInstance(KEY_ALGORITHM);
            Cipher cipher = Cipher.getInstance(keyFactory.getAlgorithm());
            cipher.init(Cipher.ENCRYPT_MODE, decodePublicKey);
            int inputLen = data.length;
            int offSet = 0;
            byte[] cache;
            int i = 0;
            // 对数据分段加密
            while (inputLen - offSet > 0) {
                if (inputLen - offSet > MAX_ENCRYPT_BLOCK) {
                    cache = cipher.doFinal(data, offSet, MAX_ENCRYPT_BLOCK);
                } else {
                    cache = cipher.doFinal(data, offSet, inputLen - offSet);
                }
                out.write(cache, 0, cache.length);
                i++;
                offSet = i * MAX_ENCRYPT_BLOCK;
            }
            byte[] encryptedData = out.toByteArray();
            encodedDataStr = new String(encryptBASE64(encryptedData));
            System.out.println("公钥分段加密完毕");
        } catch (Exception e) {
            throw e;
        } finally {
            try {
                out.close();
            } catch (Exception e2) {
                // TODO: handle exception
            }
        }
        return encodedDataStr;
    }

    /**
     * Method: encrypt 
     * description: 私钥分段解密 
     * 
     * @param content
     *            解密内容，密文
     * @param privateKeyStr
     *            私钥
     * @return 明文
     * @throws Exception
     */
    public static String decrypt(String dataStr, String PrivateKey) throws Exception {
        System.out.println("私钥分段解密处理开始");

        ByteArrayOutputStream out = null;
        String decodedDataStr = null;
        try {
            out = new ByteArrayOutputStream();

            byte[] encryptedData = decryptBASE64(dataStr);
            // 获取原始私钥
            KeyFactory keyFactory = KeyFactory.getInstance(KEY_ALGORITHM);
            Key decodePrivateKey = getPrivateKeyFromBase64KeyEncodeStr(PrivateKey);
            Cipher cipher = Cipher.getInstance(keyFactory.getAlgorithm());
            cipher.init(Cipher.DECRYPT_MODE, decodePrivateKey);
            int inputLen = encryptedData.length;

            int offSet = 0;
            byte[] cache;
            int i = 0;
            // 对数据分段解密
            while (inputLen - offSet > 0) {
                if (inputLen - offSet > MAX_DECRYPT_BLOCK) {
                    cache = cipher.doFinal(encryptedData, offSet, MAX_DECRYPT_BLOCK);
                } else {
                    cache = cipher.doFinal(encryptedData, offSet, inputLen - offSet);
                }
                out.write(cache, 0, cache.length);
                i++;
                offSet = i * MAX_DECRYPT_BLOCK;
            }
            byte[] decryptedData = out.toByteArray();
            decodedDataStr = new String(decryptedData, "utf-8");
        } catch (Exception e) {
            throw e;
        } finally {
            try {
                out.close();
            } catch (Exception e2) {
                // TODO: handle exception
            }
        }
        return decodedDataStr;
    }

}