# Payment Methods API

了解允许您接受多种全球支付方式的 API。

利用 Payment Methods API，可通过单一 API 接受多种支付方式。[PaymentMethod](https://docs.stripe.com/api/payment_methods/object.md) 对象包含创建付款所需的支付方式详情。利用 Payment Methods API，您可以组合 *PaymentMethod* (PaymentMethods represent your customer's payment instruments, used with the Payment Intents or Setup Intents APIs)：

- 用 [PaymentIntent](https://docs.stripe.com/api/payment_intents.md) 收款
- 用 [SetupIntent](https://docs.stripe.com/api/setup_intents.md) 和 *Customer* (Customer objects and some v2 Account objects represent customers of your business. They let you reuse payment methods and track multiple payments) 保存付款详情供以后使用

## 支持的支付方式

要确定某个具体地点使用哪种支付方式，请查看[支付方式指南](https://stripe.com/payments/payment-methods-guide)。

本指南包括不同地区可用的支付方式、每种支付方式特征的详细说明，以及它们最适用的地理区域。您可以在 [管理平台](https://dashboard.stripe.com)中启用任何您可用的支付方式。激活通常是即时的，不需要额外的合同。

## 客户操作

有些支付方式要求您的客户采取额外步骤才能完成支付。`PaymentIntent` 对象的 `next_action` 属性指定了客户操作。

客户需要采取的一些常见操作有：

- 跳转至其银行的在线服务，完成身份验证并确认支付。
- 通过提供您发布到 Stripe API 的一次性验证码（例如微存款）来验证账户的所有权。
- 通过他们银行的线上服务页面推动资金（例如银行转账的情况）。

并非所有支付方式都要求额外的客户操作。例如，银行卡付款（要求 3DS 验证的除外）要求在收集完银行卡详情后再进一步验证。

> 对于需要客户操作的支付方式，配置 [Webhook 接收端](https://docs.stripe.com/payments/payment-methods.md#webhooks)来接收付款成功或失败的通知。

## 付款成功的立即或延迟通知

某些支付方式（例如银行卡）会即时报告支付成功或失败。其他支付方式（例如 ACH 借记）会在一段时间后延迟报告结果。对于具有即时通知的支付方式，`PaymentIntent` 状态会变为 `succeeded` 或 `requires_payment_method`。状态为 `succeeded` 表示支付已按照支付方式的处理流程成功完成，但资金仍可被退款、提出争议、退回或撤销。

延迟通知型支付方式在支付处理期间无法保证结果。在支付成功或失败之前，`PaymentIntent` 会一直保持 `processing` 状态。在此期间，我们建议保持订单处于待处理状态，直到支付成功再进行履约。

> 对于延迟通知型支付方式，请配置 [Webhook 端点](https://docs.stripe.com/payments/payment-methods.md#webhooks)，以接收关于支付是否成功的通知。

## 一次性使用或重复使用

您可以重复使用某些支付方式（例如银行卡或银行借记）进行额外的付款，不需要再次授权和收集支付详情。

您应始终设置可后续重复使用的支付方式，从而降低后续付款被拒的几率并减少支付阻力（例如[需要进行身份验证](https://docs.stripe.com/strong-customer-authentication.md)）。您可以[在接受付款时](https://docs.stripe.com/payments/checkout/save-during-payment.md)或[在不收款的情况下设置可重复使用的支付方式以供后续使用](https://docs.stripe.com/payments/save-and-reuse.md)。

单次使用的支付方式（例如某些类型的银行转账）不能绑定到客户，因为在尝试付款后即作废。

## 用 Webhook 跟踪付款状态

针对需要客户操作或具有延迟支付通知的支付方式，您可以通过创建一个[事件接收端](https://docs.stripe.com/events/set-up-events.md)来配置 Webhook。验证 [Webhook 签名](https://docs.stripe.com/webhooks.md#verify-events)，以确认事件来自 Stripe。

更新 `PaymentIntent` 状态时，Stripe 会发送以下事件：

| 事件 | 描述 | 后续步骤 |
| --- | --- | --- |
| `payment_intent.processing` | 客户的付款已成功提交至 Stripe。仅适用于[延迟通知型](https://docs.stripe.com/payments/payment-methods.md#payment-notification)支付方式。 | 等待发起的付款成功或失败 |
| `payment_intent.succeeded` | 付款成功。 | 交付购买的商品或服务。 |
| `payment_intent.payment_failed` | 付款失败了。 | 发送邮件或推送通知，要求客户使用另一支付方式。 |

### 其他跟踪选项

您还可以使用以下选项之一来跟踪支付状态：

- 如果您使用延迟通知型支付方式接受的订单量较少，您可以在 Stripe 管理平台中手动跟踪支付状态。在管理平台中，您可以[查看所有支付](https://dashboard.stripe.com/test/payments)、发送电子邮件收据、处理提现并重试失败的支付。
- 通过重复检索 `PaymentIntent` 并检查其状态来轮询 API。轮询的可靠性不如 Webhook，并且在处理高交易量时可能无法正常运行。Stripe 还会对 API 请求进行速率限制，因此请谨慎使用轮询。
- 集成合作伙伴应用以处理常见的业务工作流，例如[自动化](https://stripe.partners/?f_category=automation)或[营销与销售](https://stripe.partners/?f_category=marketing-and-sales)。

## PaymentMethod 对象

`PaymentMethod` 包含可重复使用的支付详细信息，例如银行卡的有效期或账单地址。它不包括特定于交易的信息，例如金额或货币。将 `PaymentMethod` 绑定到 `PaymentIntent`，以便在整个[支付生命周期](https://docs.stripe.com/payments/paymentintents/lifecycle.md)中使用它。

每个 `PaymentMethod` 都有一个 [type](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-type) 属性（例如 `"type": "sepa_debit"`），以及一个包含该特定支付方式相关信息的相应哈希值。

以下示例显示了一个 `sepa_debit` `PaymentMethod` 对象：

```json
{
  "id": "pm_123456789",
  "object": "payment_method",
  "billing_details": {
    "address": {...},
    "email": "jenny@example.com",
    "name": "Jenny Rosen",
    "phone": "+335555555555"
  },
  "sepa_debit": {
    "bank_code": "37040044",
    "branch_code": "94832",
    "country": "FR",
    "fingerprint": "ygEJfUjzWMGyWnZg",
    "last4": "3000"
  },
  "type": "sepa_debit",
  (...)
}
```

> 为安全地处理敏感支付信息并自动处理客户操作，Stripe 建议您用 [Stripe.js](https://docs.stripe.com/js.md#stripe-create-payment-method) 创建支付方式。

## See also

- [支付方式指南](https://stripe.com/payments/payment-methods-guide)
- [Payment Methods API 参考](https://docs.stripe.com/api/payment_methods.md)
