Node.js使用Square CardsAPI存储信用卡时找不到cardsApi组件

1. 确认SDK导入方式是否正确 #

最新版Square Node.js SDK中，Cards API的访问逻辑可能和文档描述存在差异，先检查你的导入语句是否正确。正确的导入需要明确包含CardsApi：

// CommonJS 导入
const { Client, Environment, CardsApi } = require('square');

// ES模块导入
import { Client, Environment, CardsApi } from 'square';

2. 直接初始化CardsApi实例 #

如果通过客户端实例无法访问cardsApi，可以跳过客户端包装，直接初始化CardsApi并传入配置：

async function squareCreateCard(squareCardData ){
  const cardsApi = new CardsApi({
    accessToken: "XXX HIDDEN XXX",
    environment: Environment.Sandbox,
  });
  try {
    const response = await cardsApi.createCard({
      idempotencyKey: ObjectID().toString(),
      sourceId: squareCardData.sourceId,
      card: squareCardData.card ,
    });
 
    console.log(response.result);
    return response.result;
  } catch(error) {
    console.error("An error occurred while creating the card");
    console.error(error);
    throw {
      error: true,
      message: error.message || error,
    };
  }
}

3. 验证SDK版本与文档匹配 #

执行以下命令确认当前安装的SDK版本：

npm list square

对照Square官方文档的版本说明，确认该版本是否支持通过客户端实例访问cardsApi。部分新版本SDK已改为需要单独导入CardsApi，而非通过客户端实例的属性访问。

4. 修复可能的SDK安装损坏 #

如果node_modules/square目录下确实找不到CardsApi相关文件，尝试重新安装SDK：

npm uninstall square
npm install square

内容的提问来源于stack exchange，提问作者Juan Andres Salas