民生银行接口对接201810181

### 民生银行接口对接201810181 #### 一、概述 本文档旨在详细解析民生银行接口对接方案201810181中的关键知识点，包括联合登录机制、参数加密及解密方法、订单支付接口等内容。对接过程中涉及到的技术栈包括但不限于JavaScript、C#、PHP等编程语言。 #### 二、联合登录流程及说明 **1. 客户端与服务器交互** 联合登录主要分为两种情况： - **商户拥有用户的手机号**： - 用户通过手机银行登录后，手机银行会传递参数（如手机号、用户名、积分等）至商户服务器。 - 商户获取到这些参数后，将用户的登录状态改为“已登录”。 - 若商户未收到这些参数，则在用户访问需登录资源时调用客户端登录接口完成登录。 - **商户未持有用户的手机号**： - 用户通过手机银行登录后，手机银行将用户信息传递给商户。 - 首次访问商户页面时，商户需为用户做一次绑定或让用户注册（将用户注册信息与手机传递的信息绑定在一起）。 - 注册成功后，用户后续只需在手机银行登录即可。 **2. 参数加密及解密** - **加密参数**：`paramBase64` - **格式**：`AES(telephone|CUST_NAME|CUST_IDT|CUST_IDTl UNIQUE_IDT_NO|custId|TIMESTAMP)` - **处理步骤**： - 将表中参数按指定顺序使用`|`连接起来，然后使用UTF-8编码转换为byte数组。 - 使用AES加密得到加密后的byte数组。 - 将加密后的byte数组使用Base64编码。 - **注意事项**：不同的商户或分行可根据约定传递不同的字段，不一定会每次都传递所有字段。时间戳验证默认使用5分钟窗口期。 #### 三、订单支付接口 **1. 接口调用地址** 商户可以通过以下URL调用支付接口： ``` http://shop.rongec.com/payment/unionpay/pay.php?i=10&auth=fe73b8f346afe2da789bbbd534f66b2b3a3b6836&ps=eyJ0aWQiOiIyMTUiLCJ1bmlvbnRpZCI6IjIwMTgwODExMTk0NTI5MDAwMDE2MjE4MjI4MjIiLCJ1c2VyIjpudWxsLCJmZWUiOiIwLjAwIiwidGl0bGUiOiJcdTg3OGRcdTYwZTBcdTgwNTQifQ== ``` **2. 请求参数** - **版本号(version)**：字符串类型，最长支持10个字符，表示接口版本号，默认为`1.0.0`。 - **订单号(billNo)**：字符串类型，最长支持32个字符。格式为商户号（5位）+日期时间（14位）+商户自定义序号（13位）。例如：`00001201408261023470000001`。 - **交易金额(txAmt)**：数值类型，最多支持13位整数和2位小数，例如`111111.23`。 - **币种(PayerCurr)**：字符串类型，长度为3个字符，目前仅支持人民币，默认为`156`。 - **交易日期(txDate)**：字符串类型，长度为8个字符，格式为`YYYYMMDD`，例如`20140826`。 - **交易时间(txTime)**：字符串类型，长度为6个字符，格式为`HHMMSS`，例如`102347`。 - **商户代码(corpID)**：字符串类型，长度为5个字符，由民生银行统一分配，只能包含数字。 - **商户名称(corpName)**：字符串类型，长度最大为62个字符，只能包含字母、数字和汉字，其中汉字编码格式统一为utf-8。 - **二级商户号(subCorpID)**：字符串类型，长度最大为15个字符，只能包含字母和数字，非必填项。 - **后台异步通知地址(NotifyUrl)**：字符串类型，长度最大为240个字符，为支付成功后民生银行异步通知商户的URL地址。 - **前台跳转地址(JumpUrl)**：字符串类型，长度最大为240个字符，为支付成功后页面跳转至商户的URL地址。 - **银行卡号(Account)**：字符串类型，长度最大为30个字符，输入卡号时指定该卡进行支付，目前未开放，可留空。 #### 四、技术栈 - **JavaScript**：用于前端页面的开发与交互，实现用户界面的动态效果。 - **C#**：后端开发的主要语言之一，可用于处理接口调用、数据加密解密等功能。 - **PHP**：另一种常用的后端开发语言，同样可用于处理接口相关的逻辑操作。 #### 五、总结 民生银行接口对接方案201810181涵盖了联合登录和订单支付两个核心功能模块，通过详细的流程说明和技术实现细节，确保了商户与民生银行之间的数据交互安全、高效。对于开发者而言，掌握这些关键技术点能够有效提升系统集成的效率与质量。