消费者 API 卡测试

Question

我正在尝试使用 Garden 沙盒帐户调用 /cards 端点。截至目前，我无法弄清楚如何将信用卡/借记卡添加到我的沙箱，并且端点为给定用户帐户的任何卡返回 null。

我错过了一步吗？代码看起来正确，我相信我有正确的范围：

'https://api.banno.com/consumer/auth/cardcontrols.readonly'：空， 'https://api.banno.com/consumer/claim/cards'：空

我也找不到任何可以获取完整的未屏蔽卡详细信息的文档，但这是另一个问题。我想从能够检索配置的卡开始。

谢谢！

// Cards: /users/{userId}/cards
//
async function getCards(consumerApiPath, userId, accessToken) {
  const cardApiResponse = await fetch(`${consumerApiPath}${userId}/cards`, {
    method: 'get',
    headers: { 'Authorization': 'Bearer ' + accessToken }
  });
  const cardApiJson = await cardApiResponse.json();
  const cards = cardApiJson.cards;
  return cards;
}

// returns NULL as I believe no card is configured in the Garden sandbox`

Answer 1

有几件事要解决，所以请耐心等待。

范围与声明（一般）

GET /users/{userId}/cards 端点要求

https://api.banno.com/consumer/auth/cardcontrols.readonly

OAuth 范围成为身份验证 URL 中的 scope 参数的一部分。这就是您在该端点的Access Token中获得必要权限的方式。

• Authentication（命令行） 快速入门是了解在 auth URL 中使用范围的好资源。

https://api.banno.com/consumer/claim/cards

声明可以在claims参数中使用，以在Identity Token中获得“具有完整未屏蔽卡号的借记卡和信用卡”。请注意，特定索赔属于 “受限索赔”，这意味着金融机构的管理员需要启用该索赔，然后您才能在 Identity Token 中接收数据。

• Identity Token 中的Claims 指南是了解在 auth URL 中使用声明的好资源。

（您的示例给了我一个线索，表明范围和声明之间的区别可能存在一些混淆。）

访问数字工具包（在Garden 演示机构中）

JackHenry.Dev 上的自助开发者帐户提供了在Garden 演示机构中创建测试用户等功能。该测试用户将拥有：

• 支票账户
• 储蓄账户

值得注意的是，没有为测试用户创建任何借记卡或信用卡。

卡的配置（在金融机构）

对于银行和信用合作社，通过 API 检索借记卡信息需要机构在 Banno 中为机构提供基本卡控制功能。对于信用卡，我认为需要为该机构的 Banno 签订和安装 JHA 全方位服务信用。

据我了解，其中的某些部分需要签订合同才能在 Banno 中启用该功能，但这不是我的专业领域。我建议金融机构与他们的客户代表交谈，以获取有关在 Banno 为其机构设置此设置的更多信息。