周期性支付

使用 Pelago 实现订阅和周期性支付流程。

概述

Pelago 通过支付链接与调度功能支持周期性支付。

创建订阅

const subscription = await pelago.subscriptions.create({
  customerId: 'cust_abc123',
  amount: 9.99,
  currency: 'USD',
  cryptocurrency: 'USDC',
  network: 'stellar',
  interval: 'monthly',
  intervalCount: 1,
  merchantWallet: 'GXXXXX...',
  metadata: {
    plan: 'premium',
    tier: 'monthly'
  }
});

订阅生命周期

计费周期

周期	示例
daily	每天
weekly	每 7 天
monthly	每月同一天
yearly	每年同一天

处理续费

// Webhook: subscription.payment_succeeded
app.post('/webhook', (req, res) => {
  const event = req.body;
  
  if (event.type === 'subscription.payment_succeeded') {
    const { subscriptionId, paymentId, nextBillingDate } = event.data;
    
    // 延长客户访问权限
    await extendSubscription(subscriptionId, nextBillingDate);
  }
});

取消订阅

await pelago.subscriptions.cancel('sub_abc123', {
  cancelAtPeriodEnd: true // 完成当前周期后取消
});