1. 什么是 Stripe 以及为什么需要它

Stripe 是全球领先的支付平台，帮助电商网站、SaaS 服务以及各类 Web 应用轻松接收来自全球客户的付款。官方提供的 stripe Node.js 库为开发者提供了一套完整的工具，用于将 Stripe 支付 API 集成到应用的后端。它封装了直接调用 Stripe API 的 HTTP 请求复杂性，提供了便捷、类型安全且可预测的 JavaScript 接口。

为什么需要这个库？在现代 Web 开发中，安全处理支付是最关键的任务之一。Stripe 负责遵守 PCI DSS 标准、处理敏感数据（如卡号、CVV）以及管理复杂场景（如订阅、退款、争议）。Node.js 库让您可以轻松创建支付表单、管理客户、创建订阅、处理 Webhook 以及生成报告——所有这些都基于 Promise 的异步代码实现。

借助这个库，您可以专注于应用的业务逻辑，而无需关心支付协议的底层细节。它非常适合运行在 Express、Koa、Fastify 或任何其他框架上的 Node.js 应用。该库由 Stripe 公司积极维护，定期更新，并拥有庞大的社区支持。

2. 安装

要在您的 Node.js 项目中安装 Stripe 库，请使用 npm 或 yarn 包管理器。在项目根目录下执行以下任一命令：

# 使用 npm
npm install stripe

# 使用 yarn
yarn add stripe

安装完成后，您可以在代码中导入该库：

// 现代语法 (ES Modules)
import Stripe from 'stripe';

// 或 CommonJS (Node.js 默认)
const Stripe = require('stripe');

重要提示： 使用该库需要您的密钥（测试模式使用 sk_test_...，生产模式使用 sk_live_...）。您可以在 Stripe 管理后台 获取密钥。

3. 快速上手——最小可用示例

让我们创建一个简单的脚本，用于创建 PaymentIntent（支付意图）——这是接受一次性付款的标准方式。

// 导入库
const Stripe = require('stripe');
// 使用密钥初始化（请替换为您的测试密钥）
const stripe = Stripe('sk_test_XXXXXXXXXXXXXXXXXXXXXXXX');

async function createPayment() {
    try {
        // 创建一个金额为 2000 美分（20 美元）的 PaymentIntent
        const paymentIntent = await stripe.paymentIntents.create({
            amount: 2000,
            currency: 'usd',
            // 支付描述（可选）
            description: '来自 Node.js 的测试支付',
            // 自动捕获支付（true）或仅授权（false）
            capture_method: 'automatic',
        });

        console.log('PaymentIntent 创建成功：');
        console.log(`ID: ${paymentIntent.id}`);
        console.log(`状态: ${paymentIntent.status}`);
        console.log(`金额: ${paymentIntent.amount} ${paymentIntent.currency.toUpperCase()}`);
    } catch (error) {
        console.error('创建 PaymentIntent 时出错：', error.message);
    }
}

createPayment();

这段代码