Stripe Payment Links：实现固定金额资金转移与分配的实践指南

理解 Stripe Payment Links 与资金分配机制

stripe payment links 提供了一种快速创建支付链接的方式，用户无需编写复杂的后端代码即可接受支付。在某些业务场景中，例如平台需要将部分收款分发给其关联账户（connected account），或者平台自身需要收取一定比例的佣金时，stripe 提供了相应的参数来处理这些资金分配逻辑。

核心的资金分配机制主要通过 transfer_data 和 application_fee_amount（或 application_fee_percent）这两个参数来实现。

使用 transfer_data 进行固定金额转移

transfer_data 参数允许您在创建 Payment Link 时，指定将本次支付金额的一部分转移到指定的关联账户。这种转移是基于一个固定金额进行的。

参数详解：

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

• transfer_data.amount: 必填项，表示要转移到关联账户的金额，单位为最小货币单位（例如，美元为美分）。
• transfer_data.destination: 必填项，指定接收资金的关联账户 ID。

示例代码：

以下代码演示了如何创建一个 Payment Link，并指定将支付总额中的 40 个单位（例如，40 美分）转移到 ID 为 destination 的关联账户。

import stripe

# 假设您已配置 Stripe API 密钥
# stripe.api_key = 'YOUR_SECRET_KEY'

try:
    payment_link = stripe.PaymentLink.create(
        line_items=[{"price": "price_12345", "quantity": 1}], # 替换为您的实际价格 ID
        transfer_data={"amount": 40, "destination": "acct_YOUR_CONNECTED_ACCOUNT_ID"}
    )
    print(f"Payment Link URL: {payment_link.url}")
except stripe.error.StripeError as e:
    print(f"创建 Payment Link 失败: {e}")

注意事项：

• transfer_data.amount 必须是一个预先确定的固定数值。
• 此功能适用于需要向特定关联账户转移固定金额的场景，例如供应商固定佣金或特定服务费用。

平台佣金：application_fee_amount

除了将资金转移给关联账户，平台自身也可能需要从每笔交易中收取佣金。Stripe 提供了 application_fee_amount 参数来实现这一目的。

参数详解：

• application_fee_amount: 平台从本次支付中保留的固定金额，单位为最小货币单位。

示例：

如果您希望平台保留 50 个单位（例如，50 美分）作为佣金：

import stripe

try:
    payment_link = stripe.PaymentLink.create(
        line_items=[{"price": "price_12345", "quantity": 1}],
        application_fee_amount=50
    )
    print(f"Payment Link URL: {payment_link.url}")
except stripe.error.StripeError as e:
    print(f"创建 Payment Link 失败: {e}")

transfer_data 与 application_fee_amount 的关系： 您可以同时使用 transfer_data 和 application_fee_amount。在这种情况下，Stripe 会先从总金额中扣除 application_fee_amount 给平台，然后从剩余金额中扣除 transfer_data.amount 给关联账户。如果总金额不足以支付这两者，Stripe 会报错。

百分比分配的限制

Stripe Payment Links 确实有一个 application_fee_percent 参数，但此参数仅适用于订阅产品。这意味着，如果您创建的是一次性支付的 Payment Link，并且希望根据支付总额的百分比来分配资金（无论是给关联账户还是作为平台佣金），application_fee_percent 将无法使用。

对于一次性支付，尤其是当产品价格由客户自定义选择时（例如，捐赠或自定义金额服务），Payment Links 无法直接实现百分比形式的资金分配。这是因为在创建 Payment Link 时，系统需要一个确定的金额来计算 transfer_data.amount 或 application_fee_amount。如果最终支付金额不确定，则无法预设一个固定金额来代表百分比。

核心限制：

• transfer_data.amount 必须是固定金额。
• application_fee_amount 必须是固定金额。
• application_fee_percent 仅对订阅有效。

因此，如果您希望为自定义定价的一次性产品实现百分比形式的资金分配，Stripe Payment Links 并非最直接的解决方案。您可能需要考虑使用 Stripe Checkout Sessions 或直接的 Charges API，在支付完成后获取实际支付金额，然后通过后端逻辑计算并执行后续的资金转移或分配。

总结

Stripe Payment Links 为固定金额的资金转移和平台佣金收取提供了便捷的解决方案，通过 transfer_data 和 application_fee_amount 参数可以轻松实现。然而，对于一次性支付且金额不确定的产品，若需要进行百分比形式的资金分配，Stripe Payment Links 存在局限性。在这种情况下，开发者需要探索更灵活的 API 集成方式，以满足复杂的资金分配需求。

以上就是Stripe Payment Links：实现固定金额资金转移与分配的实践指南的详细内容，更多请关注php中文网其它相关文章！