AcpService (IJPay 1.2.2 API)

java.lang.Object
- com.jpay.unionpay.AcpService

```
public class AcpService
extends Object
```

构造器概要

构造器
构造器和说明

AcpService()

构造器
构造器和说明
`AcpService()`

方法概要

所有方法静态方法具体方法已过时的方法
限定符和类型	方法和说明
`static String`	`base64Decode(String base64Str, String encoding)` 对base64的字符串解base64
`static String`	`base64Encode(String rawStr, String encoding)` 对字符串做base64
`static String`	`createAutoFormHtml(String reqUrl, Map<String,String> hiddens, String encoding)` 功能：前台交易构造HTTP POST自动提交表单
`static String`	`deCodeFileContent(Map<String,String> resData, String fileDirectory, String encoding)` 功能：解析交易返回的fileContent字符串并落地（解base64，解DEFLATE压缩并落地）适用到的交易：对账文件下载，批量交易状态查询
`static String`	`decryptData(String base64EncryptedInfo, String encoding)` 敏感信息解密，使用配置文件acp_sdk.properties解密
`static String`	`decryptData(String base64EncryptedInfo, String certPath, String certPwd, String encoding)` 敏感信息解密,通过传入的私钥解密
`static String`	`enCodeFileContent(String filePath, String encoding)` 功能：将批量文件内容使用DEFLATE压缩算法压缩，Base64编码生成字符串并返回适用到的交易：批量代付，批量代收，批量退货
`static String`	`encryptData(String data, String encoding)` 敏感信息加密并做base64(卡号，手机号，cvn2,有效期）
`static String`	`encryptPin(String accNo, String pin, String encoding)` 密码加密并做base64
`static String`	`encryptTrack(String trackData, String encoding)` 已过时。
`static int`	`genLuhn(String number)` 获取
`static String`	`getCardTransData(Map<String,String> cardTransDataMap, Map<String,String> requestData, String encoding)` 有卡交易信息域(cardTransData)构造所有子域需用“{}”包含，子域间以“&”符号链接。
`static String`	`getCustomerInfo(Map<String,String> customerInfoMap, String accNo, String encoding)` 功能：持卡人信息域customerInfo构造说明：不勾选对敏感信息加密权限使用旧的构造customerInfo域方式，不对敏感信息进行加密（对 phoneNo，cvn2， expired不加密），但如果送pin的话则加密
`static String`	`getCustomerInfoWithEncrypt(Map<String,String> customerInfoMap, String accNo, String encoding)` 功能：持卡人信息域customerInfo构造，勾选对敏感信息加密权限适用新加密规范，对pin和phoneNo，cvn2，expired加密适用到的交易：
`static String`	`getEncryptCertId()` 获取敏感信息加密证书的物理序列号
`static String`	`getFileContent(String fileContent, String encoding)` 功能：将结果文件内容转换成明文字符串：解base64,解压缩适用到的交易：批量交易状态查询
`static Map<String,String>`	`parseCustomerInfo(String customerInfo, String encoding)` 解析返回报文（后台通知）中的customerInfo域：解base64,如果带敏感信息加密 encryptedInfo 则将其解密并将 encryptedInfo中的域放到customerInfoMap返回
`static Map<String,String>`	`parseCustomerInfo(String customerInfo, String certPath, String certPwd, String encoding)` 解析返回报文（后台通知）中的customerInfo域：解base64,如果带敏感信息加密 encryptedInfo 则将其解密并将 encryptedInfo中的域放到customerInfoMap返回
`static Map<String,String>`	`sign(Map<String,String> reqData, String encoding)` 请求报文签名(使用配置文件中配置的私钥证书或者对称密钥签名) 功能：对请求报文进行签名,并计算赋值certid,signature字段并返回
`static Map<String,String>`	`signByCertInfo(Map<String,String> reqData, String certPath, String certPwd, String encoding)` 多证书签名(通过传入私钥证书路径和密码签名）功能：如果有多个商户号接入银联,每个商户号对应不同的证书可以使用此方法:传入私钥证书和密码(并且在acp_sdk.properties中配置 acpsdk.singleMode=false)
`static Map<String,String>`	`signBySecureKey(Map<String,String> reqData, String secureKey, String encoding)` 多密钥签名(通过传入密钥签名) 功能：如果有多个商户号接入银联,每个商户号对应不同的证书可以使用此方法:传入私钥证书和密码(并且在acp_sdk.properties中配置 acpsdk.singleMode=false)
`static int`	`updateEncryptCert(Map<String,String> resData, String encoding)` 获取应答报文中的加密公钥证书,并存储到本地,备份原始证书,并自动替换证书更新成功则返回1，无更新返回0，失败异常返回-1
`static boolean`	`validate(Map<String,String> rspData, String encoding)` 验证签名(SHA-1摘要算法)
`static boolean`	`validateBySecureKey(Map<String,String> rspData, String secureKey, String encoding)` 多密钥验签(通过传入密钥签名)

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - AcpService
```
public AcpService()
```
- 方法详细资料
  - sign
```
public static Map<String,String> sign(Map<String,String> reqData,
                                      String encoding)
```
    请求报文签名(使用配置文件中配置的私钥证书或者对称密钥签名)
    功能：对请求报文进行签名,并计算赋值certid,signature字段并返回
    
    参数:
    
    reqData - 请求报文map
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    签名后的map对象
  - signByCertInfo
```
public static Map<String,String> signByCertInfo(Map<String,String> reqData,
                                                String certPath,
                                                String certPwd,
                                                String encoding)
```
    多证书签名(通过传入私钥证书路径和密码签名）
    功能：如果有多个商户号接入银联,每个商户号对应不同的证书可以使用此方法:传入私钥证书和密码(并且在acp_sdk.properties中配置 acpsdk.singleMode=false)
    
    参数:
    
    reqData - 请求报文map
    
    certPath - 签名私钥文件（带路径）
    
    certPwd - 签名私钥密码
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    签名后的map对象
  - signBySecureKey
```
public static Map<String,String> signBySecureKey(Map<String,String> reqData,
                                                 String secureKey,
                                                 String encoding)
```
    多密钥签名(通过传入密钥签名)
    功能：如果有多个商户号接入银联,每个商户号对应不同的证书可以使用此方法:传入私钥证书和密码(并且在acp_sdk.properties中配置 acpsdk.singleMode=false)
    
    参数:
    
    reqData - 请求报文map
    
    secureKey - 签名对称密钥
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    签名后的map对象
  - validate
```
public static boolean validate(Map<String,String> rspData,
                               String encoding)
```
    验证签名(SHA-1摘要算法)
    
    参数:
    
    resData - 返回报文数据
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    true 通过 false 未通过
  - validateBySecureKey
```
public static boolean validateBySecureKey(Map<String,String> rspData,
                                          String secureKey,
                                          String encoding)
```
    多密钥验签(通过传入密钥签名)
    
    参数:
    
    resData - 返回报文数据
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    true 通过 false 未通过
  - createAutoFormHtml
```
public static String createAutoFormHtml(String reqUrl,
                                        Map<String,String> hiddens,
                                        String encoding)
```
    功能：前台交易构造HTTP POST自动提交表单
    
    参数:
    
    action - 表单提交地址
    
    hiddens - 以MAP形式存储的表单键值
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    构造好的HTTP POST交易表单
  - enCodeFileContent
```
public static String enCodeFileContent(String filePath,
                                       String encoding)
```
    功能：将批量文件内容使用DEFLATE压缩算法压缩，Base64编码生成字符串并返回
    适用到的交易：批量代付，批量代收，批量退货
    
    参数:
    
    filePath - 批量文件-全路径文件名
    
    返回:
  - deCodeFileContent
```
public static String deCodeFileContent(Map<String,String> resData,
                                       String fileDirectory,
                                       String encoding)
```
    功能：解析交易返回的fileContent字符串并落地（解base64，解DEFLATE压缩并落地）
    适用到的交易：对账文件下载，批量交易状态查询
    
    参数:
    
    resData - 返回报文map
    
    fileDirectory - 落地的文件目录（绝对路径）
    
    encoding - 上送请求报文域encoding字段的值
  - getFileContent
```
public static String getFileContent(String fileContent,
                                    String encoding)
```
    功能：将结果文件内容转换成明文字符串：解base64,解压缩
    适用到的交易：批量交易状态查询
    
    参数:
    
    fileContent - 批量交易状态查询返回的文件内容
    
    返回:
    
    内容明文
  - getCustomerInfo
```
public static String getCustomerInfo(Map<String,String> customerInfoMap,
                                     String accNo,
                                     String encoding)
```
    功能：持卡人信息域customerInfo构造
    说明：不勾选对敏感信息加密权限使用旧的构造customerInfo域方式，不对敏感信息进行加密（对 phoneNo，cvn2， expired不加密），但如果送pin的话则加密
    
    参数:
    
    customerInfoMap - 信息域请求参数 key送域名value送值,必送
    例如：customerInfoMap.put("certifTp", "01"); //证件类型
    customerInfoMap.put("certifId", "341126197709218366"); //证件号码
    customerInfoMap.put("customerNm", "互联网"); //姓名
    customerInfoMap.put("phoneNo", "13552535506"); //手机号
    customerInfoMap.put("smsCode", "123456"); //短信验证码
    customerInfoMap.put("pin", "111111"); //密码（加密）
    customerInfoMap.put("cvn2", "123"); //卡背面的cvn2三位数字（不加密）
    customerInfoMap.put("expired", "1711"); //有效期年在前月在后（不加密)
    
    accNo - customerInfoMap送了密码那么卡号必送,如果customerInfoMap未送密码pin，此字段可以不送
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    base64后的持卡人信息域字段
  - getCustomerInfoWithEncrypt
```
public static String getCustomerInfoWithEncrypt(Map<String,String> customerInfoMap,
                                                String accNo,
                                                String encoding)
```
    功能：持卡人信息域customerInfo构造，勾选对敏感信息加密权限适用新加密规范，对pin和phoneNo，cvn2，expired加密
    适用到的交易：
    
    参数:
    
    customerInfoMap - 信息域请求参数 key送域名value送值,必送
    例如：customerInfoMap.put("certifTp", "01"); //证件类型
    customerInfoMap.put("certifId", "341126197709218366"); //证件号码
    customerInfoMap.put("customerNm", "互联网"); //姓名
    customerInfoMap.put("smsCode", "123456"); //短信验证码
    customerInfoMap.put("pin", "111111"); //密码（加密）
    customerInfoMap.put("phoneNo", "13552535506"); //手机号（加密）
    customerInfoMap.put("cvn2", "123"); //卡背面的cvn2三位数字（加密）
    customerInfoMap.put("expired", "1711"); //有效期年在前月在后（加密）
    
    accNo - customerInfoMap送了密码那么卡号必送,如果customerInfoMap未送密码PIN，此字段可以不送
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    base64后的持卡人信息域字段
  - parseCustomerInfo
```
public static Map<String,String> parseCustomerInfo(String customerInfo,
                                                   String encoding)
```
    解析返回报文（后台通知）中的customerInfo域：
    解base64,如果带敏感信息加密 encryptedInfo 则将其解密并将 encryptedInfo中的域放到customerInfoMap返回
    
    参数:
    
    customerInfo -
    
    encoding -
    
    返回:
  - parseCustomerInfo
```
public static Map<String,String> parseCustomerInfo(String customerInfo,
                                                   String certPath,
                                                   String certPwd,
                                                   String encoding)
```
    解析返回报文（后台通知）中的customerInfo域：
    解base64,如果带敏感信息加密 encryptedInfo 则将其解密并将 encryptedInfo中的域放到customerInfoMap返回
    
    参数:
    
    customerInfo -
    
    encoding -
    
    返回:
  - encryptPin
```
public static String encryptPin(String accNo,
                                String pin,
                                String encoding)
```
    密码加密并做base64
    
    参数:
    
    accNo - 卡号
    
    pwd - 密码
    
    encoding -
    
    返回:
    
    加密的内容
  - encryptData
```
public static String encryptData(String data,
                                 String encoding)
```
    敏感信息加密并做base64(卡号，手机号，cvn2,有效期）
    
    参数:
    
    data - 送 phoneNo,cvn2,有效期
    
    encoding -
    
    返回:
    
    加密的密文
  - decryptData
```
public static String decryptData(String base64EncryptedInfo,
                                 String encoding)
```
    敏感信息解密，使用配置文件acp_sdk.properties解密
    
    参数:
    
    base64EncryptedInfo - 加密信息
    
    encoding -
    
    返回:
    
    解密后的明文
  - decryptData
```
public static String decryptData(String base64EncryptedInfo,
                                 String certPath,
                                 String certPwd,
                                 String encoding)
```
    敏感信息解密,通过传入的私钥解密
    
    参数:
    
    base64EncryptedInfo - 加密信息
    
    certPath - 私钥文件（带全路径）
    
    certPwd - 私钥密码
    
    encoding -
    
    返回:
  - encryptTrack
```
public static String encryptTrack(String trackData,
                                  String encoding)
```
    已过时。
    
    5.0.0加密磁道信息，5.1.0接口请勿使用
    
    参数:
    
    trackData - 待加密磁道数据
    
    encoding - 编码格式
    
    返回:
    
    加密的密文
  - getEncryptCertId
```
public static String getEncryptCertId()
```
    获取敏感信息加密证书的物理序列号
    
    返回:
  - base64Encode
```
public static String base64Encode(String rawStr,
                                  String encoding)
                           throws IOException
```
    对字符串做base64
    
    参数:
    
    rawStr -
    
    encoding -
    
    抛出:
    
    IOException
  - base64Decode
```
public static String base64Decode(String base64Str,
                                  String encoding)
                           throws IOException
```
    对base64的字符串解base64
    
    参数:
    
    base64Str -
    
    encoding -
    
    抛出:
    
    IOException
  - getCardTransData
```
public static String getCardTransData(Map<String,String> cardTransDataMap,
                                      Map<String,String> requestData,
                                      String encoding)
```
    有卡交易信息域(cardTransData)构造
    所有子域需用“{}”包含，子域间以“&”符号链接。格式如下：{子域名1=值&子域名2=值&子域名3=值}
    说明：本示例仅供参考，开发时请根据接口文档中的报文要素组装
    
    参数:
    
    cardTransDataMap - cardTransData的数据
    
    requestData - 必须包含merId、orderId、txnTime、txnAmt，磁道加密时需要使用
    
    encoding - 编码
    
    返回:
  - updateEncryptCert
```
public static int updateEncryptCert(Map<String,String> resData,
                                    String encoding)
```
    获取应答报文中的加密公钥证书,并存储到本地,备份原始证书,并自动替换证书
    更新成功则返回1，无更新返回0，失败异常返回-1
    
    参数:
    
    resData - 返回报文
    
    encoding -
    
    返回:
  - genLuhn
```
public static int genLuhn(String number)
```
    获取
    
    参数:
    
    number -
    
    返回:

类 AcpService

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

AcpService

方法详细资料

sign

signByCertInfo

signBySecureKey

validate

validateBySecureKey

createAutoFormHtml

enCodeFileContent

deCodeFileContent

getFileContent

getCustomerInfo

getCustomerInfoWithEncrypt

parseCustomerInfo

parseCustomerInfo

encryptPin

encryptData

decryptData

decryptData

encryptTrack

getEncryptCertId

base64Encode

base64Decode

getCardTransData

updateEncryptCert

genLuhn