统一入口(国密版)

交互方式

交互方式为采用HTTPS/HTTP协议进行通讯

基本信息

请求参数

请求公共参数header说明

请求示例

header={"charset":"UTF-8","dgtlEnvlp":"","terminalId":"100003229","ncrptnSN":"4026170978","version":"1.0","signSN":"1387287848","verifyType":"10","memberId":"100000178","timestamp":"2023-03-01 18:07:25"}
body={"marketingInfo":"100000178,12","memberId":100,"memberTransId":"1677665242473","orderAmt":"10000","reqAddtion":"附加信息","shareNotifyUrl":"https://www.baidu.com","terminalId":100003154,"tradeCode":2,"tradeDate":"20230301180722"}
sign=304502207C4707192CA8870D3F262D9D25794CBA2D9838DBB27FA794DE6E7C1849CF2565022100AF56D1A6BD2C69D386293B771459C52CD8DA9E07329126FD09EE41DBF4BB31DA

返回参数

返回公共参数header说明

返回示例

{
 "body":"{\"errorCode\":\"0000\",\"errorMsg\":\"成功\",\"retCode\":\"1\"}", 
  "header":"{\"dgtlEnvlp\":\"04A2EBC51256064080269FC46AA6E6A1FC07723A455B5C2C41960CFAA494DFFAA5B4472A68D4CD956BA7E5FB89B2A8EC93E0519C2E021FE29A93E45BA3C31D31B8606FBE8097EA114A3CB2869783627CEEA5652E69A424A319F03FF00EB592A8A4CD0371E904F6180D57BA8173B11D56FF367FB3926003BA69BD6DC072BBD10DF1\",\"memberId\":\"100000178\",\"ncrptnSN\":\"4026170978\",\"serviceTp\":\"T-1001-024-05\",\"signSN\":\"1387287848\",\"sysRespCode\":\"S_0000\",\"sysRespDesc\":\"请求正常\",\"terminalId\":\"100003229\",\"verifyType\":\"10\"}",
  "sign":"3046022100E1703DDBA216F10EE5EFF6EB311C78A410AC3015C0D0490384BE026E92A1B31F022100D34DF5AFECFA96333557C88CBBFA66CD3E4A59B46248D1E17DD0E060D018DFE8"
}

签名/验签算法

数字信封明文

对接说明–请求处理：

1。如果业务参数中有需要进行数字证书脱敏的

• 当verifyType =10
  • 使用SM4 生成16进制的数字信封
  • 使用该数字信封对业务参数中的特殊数据进行加密脱敏
  • 将该密钥使用宝付的公钥，通过sm2国密加密算法进行加密，然后16进制输出得到dgtlEnvlp
• 当verifyType =11
  • 使用AES-256生成对成密钥作为数字信封
  • 使用该数字信封对业务参数中的特殊数据进行加密脱敏
  • 将该密钥使用宝付的公钥，通过RSA加密算法进行加密，然后16进制输出得到dgtlEnvlp

2.通过商户自己的私钥，使用sm2国密或RSA签名算法，对header+body进行签名并做16进制转码，得到sign

对接说明-返回处理

• 如果请求正常，请先使用宝付的公钥，对sign进行验签
• 使用自己的私钥对返回的数字信封解密(可选)
• 使用数字信封对业务数据进行相关脱敏(可选)

错误码说明