调用含transfers.write权限的Banno Consumer API转账接口返回404

API端点 #

POST https://digital.garden-fi.com/a/consumer/api/v0/users/{userId}/transfers

cURL请求 #

curl --location 'https://digital.garden-fi.com/a/consumer/api/v0/users/f76ae791-effa-4258-b137-d09dfdee4946/transfers' \
--header 'client-id: <client-id>' \
--header 'client-secret: <client-secret>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access-token>' \
--data '{
  "fromAccountId": "423ae4e5-83a2-4102-8a1d-9620286491b2",
  "toAccountId": "d39e8cda-2d7e-40c4-9e43-0b3b98a992b6",
  "amount": "1.00",
  "memo": "RAF Referral Reward",
  "frequency": "OneTime"
}'

已添加的权限范围 #

生成访问令牌时已包含以下权限范围：

openid https://api.banno.com/consumer/auth/transfers.write

问题详情 #

• API返回内容：

  404 Not Found
  Requested resource could not be found
  

• 认证状态有效（令牌生成成功）
• 其他API（如账户或交易API）可正常调用

咨询问题 #

1. /transfers端点在Consumer API中是否默认启用，还是需要额外配置？
2. 当前Digital Garden沙箱环境下，发起转账的端点URL是否正确？

额外上下文 #

• 环境：Digital Garden（沙箱）
• 使用OAuth2及Bearer令牌认证
• 令牌包含transfers.write权限范围

问题解答 #

1. /transfers端点启用规则
   Banno Consumer API的/transfers端点并非默认对所有客户端开放，需要联系Banno支持团队或账户经理，确认是否为你的沙箱客户端启用了转账功能。部分金融机构会限制该端点访问权限，需完成额外配置流程（如功能申请、合规审核）后才能使用。

2. 沙箱环境端点URL验证
   Digital Garden沙箱环境的转账端点URL可能存在版本或路径差异，可从以下几点排查：

   • 确认API版本：部分沙箱环境已启用v1版本API，而非v0，需核对官方指定的沙箱专属端点路径。
   • 检查路径层级：部分场景下转账端点直接挂载在/accounts路径下，而非/users/{userId}层级。
   • 验证沙箱域名：确认当前使用的沙箱域名是否为digital.garden-fi.com，部分地区沙箱可能使用不同域名后缀。

此外，可调用GET /users/{userId}/accounts接口，验证fromAccountId和toAccountId是否属于该用户、账户状态是否正常（如未冻结、支持转账操作），这也可能是触发404的潜在原因。

内容的提问来源于stack exchange，提问作者dinesh prasad bandreddi