理解 Stripe PaymentLink 与资金转移
Stripe Payment Link (支付链接) 是一种快速创建和分享支付页面的方式，无需编写复杂的代码。它允许用户直接通过链接完成支付。在某些业务场景下，平台可能需要将通过 Payment Link 收取的款项的一部分转移给其连接账户 (Connected Account)，例如服务提供商或卖家。Stripe 提供了特定的参数来实现这种资金转移。
核心参数解析
在创建 stripe.PaymentLink 时，有两个关键参数用于处理资金转移或平台费用：transfer_data 和 application_fee_amount。
1. 使用 transfer_data 进行资金转移
transfer_data 参数允许平台指定将一部分收款转移到特定的连接账户。这个参数接受一个对象，其中包含两个重要字段：
- amount：指定要转移的金额（以最小货币单位表示，例如美分）。
- destination：指定接收资金的连接账户 ID。
示例代码：
import stripe
# 假设 'price_id_xxx' 是您的产品价格ID
# 假设 'acct_XXXXXXXXXXXXXX' 是您的连接账户ID
payment_link = stripe.PaymentLink.create(
line_items=[{"price": "price_id_xxx", "quantity": 1}],
transfer_data={
"amount": 4000, # 转移40美元 (假设货币为美元，单位为美分)
"destination": "acct_XXXXXXXXXXXXXX" # 替换为您的连接账户ID
}
)
print(payment_link)在上述示例中，当客户通过此支付链接完成支付后，Stripe 将自动从总收款中扣除 40 美元并转移到指定的 destination 连接账户。
2. 使用 application_fee_amount 保留平台费用
作为 transfer_data 的替代方案，application_fee_amount 参数允许平台指定自身要保留的金额（即平台费用）。这笔费用将从总收款中扣除，并保留在平台账户中，剩余部分则流向连接账户。
示例代码：
import stripe
# 假设 'price_id_xxx' 是您的产品价格ID
payment_link_with_fee = stripe.PaymentLink.create(
line_items=[{"price": "price_id_xxx", "quantity": 1}],
application_fee_amount=500, # 平台保留5美元 (假设货币为美元，单位为美分)
# 如果使用 application_fee_amount，通常不需要再指定 transfer_data
# 因为剩余金额会自动流向连接账户（在Destination Charges模式下）
# 或通过其他方式处理。这里主要强调其作为平台费用保留的用途。
)
print(payment_link_with_fee)3. application_fee_percent 的限制
Stripe 也提供了一个 application_fee_percent 参数，允许平台以百分比的形式收取费用。然而，请注意，此参数目前仅对订阅 (Subscriptions) 生效。对于通过 PaymentLink 创建的一次性支付，您无法使用 application_fee_percent 来指定基于百分比的资金转移或平台费用。
注意事项与限制
- 固定金额转移： 对于通过 PaymentLink 处理的一次性支付，无论是使用 transfer_data 还是 application_fee_amount，都必须指定一个固定金额进行转移或作为平台费用。Stripe 不支持为一次性支付配置基于百分比的资金转移。
- 定价模型： 如果您的产品定价模型允许客户自定义选择金额，并且您希望根据这个可变金额的百分比进行转移，那么 stripe.PaymentLink 结合 transfer_data 或 application_fee_amount 可能无法直接满足您的需求。在这种情况下，您可能需要考虑更底层的 API 集成，例如使用 stripe.Checkout.Session 或 stripe.PaymentIntent，以便在服务器端计算出确切的转移金额。
- 连接账户类型： 确保您的连接账户已正确配置，并且您的平台账户具有执行资金转移所需的权限。
总结
stripe.PaymentLink 提供了一种便捷的方式来处理连接账户的资金转移，主要通过 transfer_data 和 application_fee_amount 参数实现固定金额的转移或平台费用保留。然而，对于一次性支付场景，其主要限制在于不支持基于百分比的资金转移。开发者在设计支付流程时，应充分考虑这一限制，并在必要时探索更灵活的 Stripe API 集成方案。
