Stripe 订阅服务如何固定每月1号扣款？-php教程-PHP中文网

Stripe 订阅服务如何固定每月1号扣款？

聖光之護

发布： 2025-07-15 14:30:24

原创

303人浏览过

Stripe 订阅服务如何固定每月1号扣款？

本文详细阐述了如何配置 Stripe 订阅服务，使其每月固定在1号进行扣款。核心在于选择月度计费价格方案，并利用 billing_cycle_anchor 参数将计费周期锚定到每月的第一天，确保订阅账单按预期生成，实现精准的月度固定日期扣款。

在 stripe 中管理订阅的计费周期是业务运营的关键一环，尤其当您需要所有客户在每月的特定日期（例如每月1号）进行扣款时。stripe 提供了 billing_cycle_anchor 参数，结合正确的价格配置，可以轻松实现这一需求。

核心概念解析

要实现每月1号扣款，需要理解并应用以下两个关键要素：

月度计费价格 (Recurring Price)：确保您的产品价格方案是设置为月度（recurring.interval=month）计费的。这是基础，决定了计费的频率。
计费周期锚点 (billing_cycle_anchor)：这是一个 Unix 时间戳，用于指定订阅的计费周期开始日期。当设置此参数后，Stripe 会尝试将订阅的计费日期对齐到每月这个锚点日期。例如，如果您将其设置为某个月的1号，那么后续的计费都将尝试在每月1号进行。

实现步骤

以下是配置 Stripe 订阅以固定每月1号扣款的具体步骤：

1. 创建或选择月度计费价格

首先，您需要确保您的 Stripe 产品已关联一个月度计费的价格（Price）。如果您还没有，可以通过 Stripe 控制台或 API 创建。

示例（API 创建月度价格）：

import stripe

# 假设您已经设置了Stripe API密钥
# stripe.api_key = 'YOUR_STRIPE_SECRET_KEY'

try:
    price = stripe.Price.create(
        unit_amount=1000,  # 价格，例如10美元 (1000美分)
        currency='usd',
        recurring={'interval': 'month'}, # 设置为月度计费
        product='prod_xxxxxxxxxxxxxx', # 替换为您的产品ID
        nickname='Monthly Subscription Price'
    )
    print(f"月度价格创建成功: {price.id}")
except stripe.error.StripeError as e:
    print(f"创建价格失败: {e}")

登录后复制

2. 设置订阅的计费周期锚点 (billing_cycle_anchor)

这是实现每月1号扣款的核心步骤。在创建新订阅或更新现有订阅时，将 billing_cycle_anchor 参数设置为您希望的每月1号的 Unix 时间戳。

如何获取每月1号的 Unix 时间戳：

您需要计算下一个即将到来的每月1号的午夜（UTC时间通常是最佳实践，以避免时区混淆）的 Unix 时间戳。

小绿鲸英文文献阅读器

英文文献阅读器，专注提高SCI阅读效率

199

查看详情

示例（Python 获取下一个月1号的 Unix 时间戳）：

import datetime
import calendar

def get_next_first_day_of_month_timestamp():
    """
    获取下一个即将到来的每月1号的午夜 (00:00:00) 的 Unix 时间戳。
    """
    now = datetime.datetime.now(datetime.timezone.utc) # 使用UTC时间

    # 计算下个月的年份和月份
    if now.month == 12:
        next_month_year = now.year + 1
        next_month_month = 1
    else:
        next_month_year = now.year
        next_month_month = now.month + 1

    # 创建下个月1号的日期时间对象
    first_day_of_next_month = datetime.datetime(
        next_month_year, next_month_month, 1, 0, 0, 0, tzinfo=datetime.timezone.utc
    )

    # 转换为Unix时间戳 (整数)
    return int(first_day_of_next_month.timestamp())

# 获取锚点时间戳
billing_anchor_timestamp = get_next_first_day_of_month_timestamp()
print(f"下一个月1号的Unix时间戳: {billing_anchor_timestamp}")

登录后复制

示例（创建新订阅时设置 billing_cycle_anchor）：

import stripe

# 假设您已经设置了Stripe API密钥
# stripe.api_key = 'YOUR_STRIPE_SECRET_KEY'

# 获取下一个月1号的Unix时间戳
billing_anchor_timestamp = get_next_first_day_of_month_timestamp() # 调用上面定义的函数

try:
    subscription = stripe.Subscription.create(
        customer='cus_xxxxxxxxxxxxxx',  # 替换为您的客户ID
        items=[
            {
                'price': 'price_xxxxxxxxxxxxxx',  # 替换为您的月度计费价格ID
            },
        ],
        billing_cycle_anchor=billing_anchor_timestamp,
        # proration_behavior 参数决定了如果订阅开始日期不是锚点日期，如何处理首次计费。
        # 'always_invoice' 会立即生成一个按比例计费的账单，直到锚点日期，然后在锚点日期生成完整账单。
        # 'create_prorations' 会在后续账单中包含按比例计费的调整项。
        # 根据业务需求选择，通常推荐 'always_invoice' 或 'create_prorations'。
        proration_behavior='always_invoice', 
    )
    print(f"订阅创建成功，并已锚定至每月1号: {subscription.id}")
except stripe.error.StripeError as e:
    print(f"创建订阅失败: {e}")

登录后复制

示例（更新现有订阅时设置 billing_cycle_anchor）：

如果您需要将现有订阅的计费日期调整到每月1号，可以修改其 billing_cycle_anchor。

import stripe

# 假设您已经设置了Stripe API密钥
# stripe.api_key = 'YOUR_STRIPE_SECRET_KEY'

# 获取下一个月1号的Unix时间戳
billing_anchor_timestamp = get_next_first_day_of_month_timestamp()

try:
    updated_subscription = stripe.Subscription.modify(
        'sub_xxxxxxxxxxxxxx', # 替换为要更新的订阅ID
        billing_cycle_anchor=billing_anchor_timestamp,
        proration_behavior='always_invoice', # 更新时同样需要考虑计费行为
    )
    print(f"订阅更新成功，并已锚定至每月1号: {updated_subscription.id}")
except stripe.error.StripeError as e:
    print(f"更新订阅失败: {e}")

登录后复制

注意事项

首次计费与按比例计费 (Proration)：当订阅开始日期与 billing_cycle_anchor 指定的日期不一致时，Stripe 会根据 proration_behavior 参数处理。
- 如果设置为 always_invoice，Stripe 会在订阅开始时立即生成一个按比例计费的账单（从开始日期到第一个锚点日期），然后在每个锚点日期生成完整的月度账单。
- 如果设置为 create_prorations，Stripe 不会立即生成账单，而是在下一个计费周期开始时，在账单中包含按比例计费的调整项。
- 请根据您的业务需求选择合适的 proration_behavior。
时间戳与时区：Unix 时间戳是基于 UTC 的。在计算 billing_cycle_anchor 时，建议使用 UTC 时间来避免因服务器或用户时区不同而导致的时间偏差。Stripe 内部也会使用 UTC 处理时间戳。
未来日期：billing_cycle_anchor 必须设置为未来的日期或当前日期。如果设置为过去的日期，Stripe 会将其视为下一个即将到来的该日期。例如，今天是10月15日，您将 billing_cycle_anchor 设置为10月1日，Stripe 会将其解释为11月1日。
退款与取消：设置 billing_cycle_anchor 不会影响订阅的退款或取消逻辑，这些操作仍按 Stripe 的标准流程进行。

总结

通过正确配置月度计费价格和利用 billing_cycle_anchor 参数，您可以有效地控制 Stripe 订阅的计费日期，使其每月固定在1号进行扣款。这对于需要统一账单周期或简化财务对账的业务场景非常有用。务必注意 proration_behavior 的设置，以确保首次计费行为符合您的预期。

以上就是Stripe 订阅服务如何固定每月1号扣款？的详细内容，更多请关注php中文网其它相关文章！