接入流程指引

发邮件给我们报备来源IP，邮件模板如下
:::highlight blue 📧[申请邮件模板]
邮件主题：新增IP白名单申请-商户名称XXX
发送邮箱：tech_support@lianlianpay.com

邮件内容（示例）:
新增IP白名单申请
商户号：2020042200284052
商户名称：测试商户有限公司
IP白名单：111.112.113.114,222.223.224.225
:::

以下是连连接口域名入口IP，如有需要，可以惠存

115.238.30.69,115.238.30.76,183.136.171.33
101.71.136.23,101.71.136.29
112.17.38.119,112.17.38.126
101.37.133.67,203.107.32.166

公私钥生成及配置

:::tip[]
当您的应用和连连做数据交互时，我们使用RSA公私钥加解密的方式作为身份合法性校验的一种方式。 您需要为您的应用生成属于您的公私钥对，其中私钥用于接口请求时加签使用，公钥上传到连连用于验证您系统发起的接口请求的身份合法性。
:::




生成公私钥对时，推荐使用OpenSSL完成。
- OpenSSL官方下载地址：https://www.openssl.org/source
- Openssl-0.9.8k_WIN32RSA密钥生成工具包：https://oss-mpay-static.lianlianpay.com/tps/5292a714-5013-4125-b82e-bd3a9d09057d.rar


执行如下命令，执行成功后，会在目录下生成rsa_private_key.pem文件，该文件为pkcs1格式的私钥（PHP语言使用）
bash openssl genrsa -out rsa_private_key.pem 4096
开发语言是Java或者C#的还需要将私钥格式转为pkcs8
bash openssl pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -out rsa_private_key.txt -nocrypt


执行如下命令，执行成功后，会在目录下生成rsa_public_key.pem文件
bash openssl rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem




登录 聚数商户站后台，进入商家中心选择参数配置，把上述步骤中生成的公钥rsa_public_key.pem文件，去除文件中的头部、尾部及换行在此处提交。

连连公钥用于异步通知验签和接口响应验签
text -----BEGIN PUBLIC KEY----- MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCSS/DiwdCf/aZsxxcacDnooGph3d2JOj5GXWi+q3gznZauZjkNP8SKl3J2liP0O6rU/Y/29+IUe+GTMhMOFJuZm1htAtKiu5ekW0GlBMWxf4FPkYlQkPE0FtaoMP3gYfh+OwI+fIRrpW3ySn3mScnc6Z700nU/VYrRkfcSCbSnRwIDAQAB -----END PUBLIC KEY-----
PS：Java或C#开发语言，需对该公钥进行去除头部、尾部及换行的处理后使用；PHP开发语言，可以直接使用

域名报备（可选）

:::tip[]
当您需要使用连连提供的收银台页面时，连连会去校验访问收银台的来源域名

要求：

• 来源域名必须有（没有带上来源域名，页面会报错：未检测到请求来源域名）
• 该来源域名必须是在连连报备过的（没有报备，页面会报错：来源域名未报备）
  :::
  PS：没有使用连连的收银台页面，可以不需要进行域名报备

需联系连连商务同事走内部流程发起域名报备申请（只能报备二级域名）

线下加款通知地址配置（可选）

有线下加款场景的时候，需要提供线下加款通知地址给技术支持配置在商户号上，邮件模板如下。
加款成功后，会有异步通知到这个地址。
通知信息详情请看 线下加款成功通知
:::highlight blue 📧[申请邮件模板]
邮件主题：商户线下加款异步通知地址配置申请-商户名称XXX
发送邮箱：tech_support@lianlianpay.com

邮件内容（示例）:
xxxx商户线下加款异步通知地址配置申请
商户号：2020042200284052
商户名称：测试商户有限公司
线下加款异步通知地址：https://abc.xxxxx.com/
:::

签名机制

为保证您与连连之间消息来往的安全性，防止支付或者通知的数据被伪造，篡改，连连要求对所有来往的信息加入签名机制。
连连目前采用的是 RSA 加密方式中的md5withRSA算法实现的签名机制。


签名内容产生规则：
1. 获取请求完整JSON报文，使用MD5计算出报文摘要值（全小写）
2. 将该MD5计算出的摘要值按照md5withRSA的签名算法，使用您的私钥进行加签
3. 将签名值使用Base64转码得到签名串signature
4. 将签名方式和签名值设置在http header中，并自定义如下对应属性（Signature-Data）：

| 自定义Header key | 是否必须 | 描述 |
| --- | --- | --- |
| Signature-Type | 是 | 签名方式：RSA |
| Signature-Data | 是 | 签名值RSA签名，见安全签名机制<br>Signature-Data = Base64(RSA(MD5(完整JSON报文))) |
| mch_id | 可选 | 商户在连连系统中的唯一标识，mch_id和sp_no需传其一即可 |
| sp_no | 可选 | 服务商编号，mch_id和sp_no需传其一即可 |
| timestamp | 是 | 时间戳，格式：yyyyMMddHHmmss，例如20250106145022 |

### **签名生成流程（体验）**
  以下签名生成流程使用**测试环境测试商户号**调用 [卡bin查询](https://open.lianlianpay.com/docs/multipayment/bin-query-pure.html) 接口为例，进行演示。
  请求json报文:
    ```json
    {"card_no":"9558834301000461394","mch_id":"2020042200284052"}
    ```
    <Steps>
      <Step title="生成请求Json报文的MD5摘要值">
        使用 [MD5在线生成工具](http://tool.haooyou.com/code?group=hash&type=md5&charset=UTF-8) 生成请求Json报文的MD5摘要值（32位小写）
        MD5摘要值为：
        ```text
        51a592df873c64dd2c2c88ce8c365ec7
        ```

使用 RSA私钥加签在线工具 对步骤1生成的MD5摘要值进行RSA私钥加签（测试商户号私钥）
签名值为：
text q2G8ulbvKZEOkBCeyK8s++rATQfMjvn0JhQGELe7wn8Qih0qmuM3pgjJ9BVDza3qcGcLbKXfUCusBW17fAjyyWz33ucgxyS9VVUrgFsO0acVlrQK7xJpIy0X6Z2jjNvSZhpPxLxktDZyRHA7WGQZFo1SL5HsUMlBIxj69OjAG2c=



请求头headers配置信息：

发起请求：





签名内容产生规则：
1. 连连向您发送的信息，您需要进行验签，确保信息没有被篡改
2. 从请求体中获取连连向您发送的信息完整JSON报文，使用MD5计算出报文摘要值（全小写）
3. 从请求头中获取连连向您发送信息的签名值
4. 使用RSA公钥验签方法对MD5摘要值和签名值进行校验

### **验签流程（体验）**
  使用如下内容进行验签过程演示
  连连发送的信息完整JSON报文：
    ```json

{"accountInfo":{"accountLevel":"V3","accountNeedLevel":"V3","accountNeedType":"PERSONAL_PAYMENT_ACCOUNT","accountType":"PERSONAL_PAYMENT_ACCOUNT"},"accp_txno":"20230829000012374866","oid_partner":"2020042200284052","oid_userno":"2023082813762354","txn_seqno":"1696339459111317504","user_id":"741852963","user_status":"NORMAL"}
连连发送信息的签名值： text
Gkb/kkuByKHzsPPmAn89hjvxsyJZN02dUCaa5m0nf9fxdaWDCvo5mZdhYz6XBrDY7dg0kgM/yMyEpalCA+24mIW80OjL+yLTUkJMcGcCaEBDjMyT30KwU2jkbbGUmLMSfTdBUoPFTqeEQRNXibP1c0uszWwuiQToOkiSg0UpvXM=
```

    <Steps>
      <Step title="生成请求Json报文的MD5摘要值">
        使用 [MD5在线生成工具](http://tool.haooyou.com/code?group=hash&type=md5&charset=UTF-8) 生成请求Json报文的MD5摘要值（32位小写）
        MD5摘要值为：
        ```text
        dc21d276613d34970c10356adb9a8176
        ```

使用 RSA私钥加签在线工具 对步骤1生成的MD5摘要值和请求头的签名值进行RSA公钥验签（连连公钥）

点击验签按钮后，签名结果方框中会显示本次验签的结果



### 连连验签公钥
连连公钥用于异步通知验签和接口响应验签
text -----BEGIN PUBLIC KEY----- MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCSS/DiwdCf/aZsxxcacDnooGph3d2JOj5GXWi+q3gznZauZjkNP8SKl3J2liP0O6rU/Y/29+IUe+GTMhMOFJuZm1htAtKiu5ekW0GlBMWxf4FPkYlQkPE0FtaoMP3gYfh+OwI+fIRrpW3ySn3mScnc6Z700nU/VYrRkfcSCbSnRwIDAQAB -----END PUBLIC KEY-----
PS：Java或C#开发语言，需对该公钥进行去除头部、尾部及换行的处理后使用；PHP开发语言，可以直接使用

公钥加密方法

RSA公钥加密

部分字段需要用RSA公钥加密后传输，加密公钥为连连的公钥，加密方法和密钥如下所示：

byte[] keyByte = org.apache.commons.codec.binary.Base64.decodeBase64(public_key);
X509EncodedKeySpec x509ek = new X509EncodedKeySpec(keyByte);
KeyFactory keyFactory = KeyFactory.getInstance("RSA");
PublicKey publicKey = keyFactory.generatePublic(x509ek);

Cipher cipher = Cipher.getInstance("RSA");
cipher.init(Cipher.ENCRYPT_MODE, publicKey);
byte[] sbt = source.getBytes(StandardCharsets.UTF_8); // //本地测试可以使用这个
byte[] epByte = cipher.doFinal(sbt);
String epStr = org.apache.commons.codec.binary.Base64.encodeBase64String(epByte);
return epStr;

超时判断规则：
- 超过5秒TCP握手没有成功，连连系统认为超时
- TCP握手成功后，超过5秒没有响应，连连系统认为超时

当您的系统首次收到异步通知时，对其做出响应，处理您的业务逻辑并置已处理的标志；之后再次收到的异步通知，均进行响应但不做业务处理。