# 汇元科技客户中心JavaDemo

**Repository Path**: huiyuan-technical-support/HyCustomerCenter

## Basic Information

- **Project Name**: 汇元科技客户中心JavaDemo
- **Description**: 汇元科技客户中心对接文档以及Java的demo
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-01-12
- **Last Updated**: 2025-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 汇元科技客户中心JavaDemo

#### 介绍

汇元科技客户中心对接文档以及Java的demo


#### 使用说明

1. 接口开发API文档：https://open.heepay.com/www/index.html#/openDoc?type=menu&id=2022360361
2. 开发环境 jdk1.8
3. 接口支持SM2和RSA2两种签名方式，目前推荐使用SM2,更安全高效,所以汇元默认让商户提供SM2密钥，每次签名生成的值都是不一样的
4. 使用SM2签名方法的,启动Application测试;使用RSA2的,启动ApplicationRsa2测试,默认都是使用SM2

#### 密钥说明

1. 密钥生成建议用支付宝密钥生成工具 官方地址： https://opendocs.alipay.com/isv/02kipk
2. 生成国密SM2密钥对（公钥、私钥）,并将公钥通过邮件发送给我方(yunyingbu@9186.com)
3. 汇元网回复客户中心商户APPID给该商户，这个一般周期一天左右，着急群里@运营或督导

#### 对接流程

入驻申请+入驻修改+入驻结果查询+文件上传+行政区划查询
1. 先调文件上传获取入驻需要文件的路径
2. 然后根据自己系统逻辑开发行政区划查询
3. 调入驻同步返回入驻编号则为汇付宝开户成功
4. 如果需要修改信息调修改接口即可
5. 同步返回不需要验签,但是异步的入驻通知需要验签,验签规则和签名同理,也可以调用   com.hynet.customer.client.common.HynetUtil.verify方法

#### 签名规则

客户中心接口无需加密，只需要签名和验签
签名通用步骤第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA 特别注意以下重要规则：
参数名ASCII码从小到大排序（字典序）；
如果参数的值为空不参与签名；
参数名区分大小写；第二步，使用商户SM2私钥对待签名字符串stringA进行签名，得到签名sign
验签用到的是汇付宝公钥验签

#### 签名密钥

##### SM2
异步通知验签密钥：MIIBMzCB7AYHKoZIzj0CATCB4AIBATAsBgcqhkjOPQEBAiEA/////v//////////\n" +
"//////////8AAAAA//////////8wRAQg/////v////////////////////8AAAAA\n" +
"//////////wEICjp+p6dn140TVqeS89lCafzl4n1FauPkt28vUFNlA6TBEEEMsSu\n" +
"LB8ZgRlfmQRGajnJlI/jC7/yZgvhcVpFiTNMdMe8Nzai9PZ3nFm9zuNraSFT0KmH\n" +
"fMYqR0AC3zLlITnwoAIhAP////7///////////////9yA99rIcYFK1O79Ak51UEj\n" +
"AgEBA0IABFM7zvtToMT87VpSM4WSmbdKka6OclquSnS57nmN13EL3hxxt3HV3p2c\n" +
"laOie/UMUDSkXs8mJLXl4EWoznOAoBw=

##### SM2
同步验签密钥：MFkwEwYHKoZIzj0CAQYIKoEcz1UBgi0DQgAEK2X3eSO4M3CSzlJfajjtlpqayQ0DQ0UfSLiAa6APukvaq3OgDnDYOfx5TeNUUGWGCKHJhBRZcB7Nccl/XCr55w==


##### RSA2
异步通知验签密钥：MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAjsr1LH1t0JbdYGjYNnACdLEX5H44cstATVJKZgqDi0h3MV0cPdNA4bENVtDvGpo6hh/tGI780OuLjBorev1/MvDaBEQPnqizm+xKQs0crtDhmH0CyWPKLAHTfJY/K0aTWcLEKvWnNtrghYps+CuH1S3+qXiB51FLlyxm7yPlNhe6gs4f2TwLfwMtwvV2CfWTD9d5u2XxLHJURtdxVOnk1x8jUj3AMgt0iGXktjMGXe/wMlDI7apAJ9escGPTb+RCnREgbumhjxLUJ2qkRjn0n011QRz56vO4UGrp9UBDcdXGUgUaxZ89mGm58YAQ071y1GaACcXrUs/73hpleBjyFwIDAQAB