Stripe订阅：设置账单周期至每月1日固定扣款的实现方法

import stripe

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

# 创建一个产品 (如果还没有)
product = stripe.Product.create(
    name="Pro Plan"
)

# 创建一个按月计费的定价 (Price)
price = stripe.Price.create(
    unit_amount=1000,  # 10.00 美元 (以最小单位表示)
    currency="usd",
    recurring={"interval": "month", "interval_count": 1}, # 每月计费
    product=product.id,
)

print(f"产品ID: {product.id}")
print(f"定价ID: {price.id}")

import datetime
import calendar
import stripe

# 替换为您的Stripe API密钥
# stripe.api_key = 'YOUR_STRIPE_SECRET_KEY'

# 假设 customer_id 和 price_id 已知
# 请替换为您的实际客户ID和按月计费的Price ID
customer_id = 'cus_xxxxxxxxxxxxxx' # 示例客户ID
price_id = 'price_xxxxxxxxxxxxxx' # 示例Price ID (来自步骤一创建的Price)

# 计算下个月1日的时间戳
today = datetime.date.today()
# 获取下个月的年份和月份
if today.month == 12:
    next_month_year = today.year + 1
    next_month = 1
else:
    next_month_year = today.year
    next_month = today.month + 1

# 构建下个月的1日日期对象
next_month_first_day = datetime.datetime(next_month_year, next_month, 1, 0, 0, 0) # 设置为UTC时间午夜

# 将日期转换为Unix时间戳 (秒)
# 注意：Stripe的billing_cycle_anchor是Unix时间戳，通常是UTC时间
billing_cycle_anchor_timestamp = int(next_month_first_day.timestamp())

print(f"目标锚定日期 (UTC): {next_month_first_day}")
print(f"对应的Unix时间戳: {billing_cycle_anchor_timestamp}")

try:
    subscription = stripe.Subscription.create(
        customer=customer_id,
        items=[{'price': price_id}],
        billing_cycle_anchor=billing_cycle_anchor_timestamp,
        # collection_method='charge_automatically', # 默认值，如果需要可显式设置
        # proration_behavior='create_prorations', # 默认值，处理周期变更时的按比例计费
    )
    print(f"\n订阅创建成功，ID: {subscription.id}")
    print(f"首次扣款日期锚定至: {datetime.datetime.fromtimestamp(subscription.billing_cycle_anchor, tz=datetime.timezone.utc)}")
    print(f"当前订阅状态: {subscription.status}")

except stripe.error.StripeError as e:
    print(f"\n创建订阅失败: {e}")

# 假设 existing_subscription_id 是您要更新的订阅ID
# existing_subscription_id = 'sub_xxxxxxxxxxxxxx'

# 重新计算目标锚定日期时间戳 (例如，下一个月的1日)
# ... (同上文计算 billing_cycle_anchor_timestamp 的代码) ...

try:
    updated_subscription = stripe.Subscription.modify(
        existing_subscription_id,
        billing_cycle_anchor=billing_cycle_anchor_timestamp,
        # proration_behavior='create_prorations', # 更改锚点时，通常希望处理按比例计费
    )
    print(f"\n订阅 {updated_subscription.id} 更新成功。")
    print(f"新的首次扣款日期锚定至: {datetime.datetime.fromtimestamp(updated_subscription.billing_cycle_anchor, tz=datetime.timezone.utc)}")
except stripe.error.StripeError as e:
    print(f"\n更新订阅失败: {e}")