1
获取用户配置文件 (Profile)
首先需要获取用户的账号，这是后续所有操作的基础。
重要： 你需要从 Wise 开发者平台获取有效的 API Token
curl -X GET "https://api.sandbox.transferwise.tech/v1/profiles" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
提示： Profile ID 是后续查询余额和流水的必要参数
2
查询账户余额 (Balances)
使用获取到的 Profile ID 查询用户的所有账户余额信息。
curl -X GET "https://api.sandbox.transferwise.tech/v4/profiles/{profileId}/balances" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
提示： 记录下需要查询流水的 Balance ID
3
查询银行流水 (第一次请求)
首次查询银行流水，系统可能会要求进行身份验证。
curl -X GET "https://api.sandbox.transferwise.tech/v1/profiles/{profileId}/balance-statements/{balanceId}/statement.json?intervalStart=2025-01-01T00:00:00.000Z&intervalEnd=2025-01-31T23:59:59.000Z" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
关键节点： 如果返回状态码
403 且包含 x-2fa-approval 和 x-2fa-approval-result 头信息，说明需要进行二次验证
4
计算签名 (Signature)
当需要二次验证时，必须计算 x-2fa-approval 值的签名。
# 获取签名（本系统提供的工具接口）
curl -X GET "http://localhost:8080/bank/wise/api/signature?value={x-2fa-approval-value}" \
-H "Content-Type: application/json"
关键节点： 签名计算必须使用正确的私钥，签名算法为 RSA-SHA256，wise的后台需要配置公钥。
5
查询银行流水 (二次验证请求)
携带验证头信息重新请求银行流水数据。
curl -X GET "https://api.sandbox.transferwise.tech/v1/profiles/{profileId}/balance-statements/{balanceId}/statement.json?intervalStart=2025-01-01T00:00:00.000Z&intervalEnd=2025-01-31T23:59:59.000Z" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "x-2fa-approval: {x-2fa-approval-value}" \
-H "X-Signature: {calculated-signature}"
成功标志： 返回状态码
200 且包含完整的流水数据
📋
重要参数说明
API Base URL
https://api.sandbox.transferwise.tech (沙箱环境)
API Base URL
https://api.transferwise.com (生产环境)
Profile ID
用户配置文件的唯一标识符
Balance ID
账户余额的唯一标识符
时间格式
ISO 8601 格式：YYYY-MM-DDTHH:mm:ss.sssZ
签名算法
RSA-SHA256 + Base64 编码
⚠️
常见问题与解决方案
1. 401 Unauthorized
检查 API Token 是否正确且未过期
2. 403 Forbidden (需要二次验证)
按照步骤 4-5 进行签名验证
3. 404 Not Found
检查 Profile ID 和 Balance ID 是否正确
4. 签名验证失败
确保使用正确的私钥和签名算法
调试建议： 使用本系统的调试工具可以自动处理这些复杂的验证步骤