Webhook
- WaaS 回调机制总览
- 回调接入准备说明
- 回调数据解密实现
- 回调枚举类型说明
- 公共请求参数
- Webhook API
接入指南
常见问题解答
- 基于性能与安全性的平衡，1024位RSA提供足够的安全性同时保证API响应速度。如有更高安全需求可联系升级
- 联系WaaS技术支持重新生成密钥对
-
确认响应状态:检查code值，非0时无需解密，直接处理业务错误
-
验证数据格式:确保data是有效Base64字符串（字母/数字/+//=组合）
-
核对公钥一致性:确认使用与请求加密相同的公钥（测试/生产环境区分）
-
检查公钥处理方式：必须先将Base64编码的公钥字符串解码为字节数组，再用于解密，不可直接使用Base64字符串进行解密操作。
- 该错误是由于尝试解密超过128字节的数据所引起的,为避免此错误，请采用分段解密的方法,具体可以参考 RSA 工具类中的代码示例。
通常由以下原因引起：
-
🚫 商户使用了错误的RSA公钥加密请求数据（与WaaS提供的公钥不一致）。
-
🔄 商户在加密前没有正确对WaaS提供的公钥进行Base64解码（注意：WaaS提供的公钥是Base64编码的，但在使用时需要先进行Base64解码）。
-
💾 请求数据在序列化过程中出现问题（如包含了非UTF-8字符，或者序列化后的JSON格式不正确）。
-
🧩 加密过程中使用的填充模式或算法与WaaS不匹配（WaaS使用的是RSA/ECB/PKCS1Padding）。
助手
Responses are generated using AI and may contain mistakes.