加解密机制

开放平台支持开发者自行对请求参数做 AES 加密后再做签名提交请求，保证通信过程中敏感信息字段（如用户的住址、银行卡号、手机号码等）的机密性。对应加密请求，财资云响应报文也会加密处理。下面详细介绍加解密的方式，以及如何进行相应的计算。
说明： 高级加密标准（英语：Advanced Encryption Standard，缩写：AES），是目前对称密钥加密中比较通用的一种加密方式，该加密方式加解密的密钥即为 AES 密钥。

加密请求

企业应用调用财资云接口时，需要对特定的请求进行加密处理。使用加密功能，需要传输加密算法和加密后的请求报文。报文加密仅针对 HttpRequestBody，path、query、header 字段不参与加密。目前加密算法支持 AES 和 SM4 两种算法。
具体加密规则：

对HTTP 请求的 body 内容，使用加密算法进行加密，得到得到 byte 数组，然后将 byte 数组通过 Base64 方法编码得到密文。

在HTTP header 中添加 x-uf-encrypt-alg，指明加密算法。

HTTP headt 指定 Content-Type 值为 text/plain。
请求示例：

解密响应

对于加密请求的成功响应，支付宝返回的报文也使用相同算法加密。请求失败的响应，支付宝不会对报文进行加密。具体解密规则如下：

对 HTTP 响应的body内容，使用 Base64 方法解码得到 byte 数组，使用加密算法对于 byte 数组进行解密，得到未加密的报文。

在 HTTP response header 中存在 x-uf-encrypt-alg 参数，指明加密算法，和请求加密算法一致。

HTTP head 指定 Content-Type 值为 text/plain。

业务成功示例：

业务失败示例：

HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=utf-8
Content-Length: 48
Connection: keep-alive
x-uf-trace-id: 0b7ac99716715915149305389e172f
 
{"code":"unknow-error","msg":"系统繁忙"}

请求内容加密

加解密机制#

加密请求#

解密响应#

加解密机制

加密请求

解密响应