payments

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/payments

/payments

Unified payment lifecycle. Audit, fix, verify—all providers, one skill.
统一支付生命周期管理。审计、修复、验证——所有提供商,一个Skill搞定。

What This Does

功能说明

Orchestrates all payment providers. Detects active systems, runs provider-specific skills, merges findings, drives fixes in priority order, verifies end-to-end payment flows.
协调所有支付提供商的工作。检测活跃系统,运行提供商专属Skill,合并检查结果,按优先级推动修复,验证端到端支付流程。

Branching

分支管理

Before making code changes:
bash
git checkout -b fix/payments-$(date +%Y%m%d)
Configuration-only changes (env vars, dashboard settings) don't require a branch.
在修改代码前:
bash
git checkout -b fix/payments-$(date +%Y%m%d)
仅修改配置(环境变量、控制台设置)无需创建分支。

Process

操作流程

1. Detect Active Providers

1. 检测活跃提供商

bash
undefined
bash
undefined

Stripe

Stripe

grep -q "stripe" package.json 2>/dev/null && echo "✓ Stripe SDK" || echo "○ No Stripe" [ -n "$STRIPE_SECRET_KEY" ] && echo "✓ STRIPE_SECRET_KEY" || echo "○ No STRIPE_SECRET_KEY"
grep -q "stripe" package.json 2>/dev/null && echo "✓ Stripe SDK" || echo "○ No Stripe" [ -n "$STRIPE_SECRET_KEY" ] && echo "✓ STRIPE_SECRET_KEY" || echo "○ No STRIPE_SECRET_KEY"

Bitcoin

Bitcoin

command -v bitcoin-cli >/dev/null && echo "✓ bitcoin-cli" || echo "○ No bitcoin-cli" [ -n "$BITCOIN_RPC_URL" ] && echo "✓ BITCOIN_RPC_URL" || echo "○ No BITCOIN_RPC_URL"
command -v bitcoin-cli >/dev/null && echo "✓ bitcoin-cli" || echo "○ No bitcoin-cli" [ -n "$BITCOIN_RPC_URL" ] && echo "✓ BITCOIN_RPC_URL" || echo "○ No BITCOIN_RPC_URL"

Lightning

Lightning

command -v lncli >/dev/null && echo "✓ lncli (LND)" || echo "○ No lncli" command -v lightning-cli >/dev/null && echo "✓ lightning-cli (CLN)" || echo "○ No lightning-cli" [ -n "$LND_DIR" ] && echo "✓ LND_DIR" || echo "○ No LND_DIR"
command -v lncli >/dev/null && echo "✓ lncli (LND)" || echo "○ No lncli" command -v lightning-cli >/dev/null && echo "✓ lightning-cli (CLN)" || echo "○ No lightning-cli" [ -n "$LND_DIR" ] && echo "✓ LND_DIR" || echo "○ No LND_DIR"

BTCPay

BTCPay

[ -n "$BTCPAY_URL" ] && echo "✓ BTCPAY_URL" || echo "○ No BTCPAY_URL" [ -n "$BTCPAY_API_KEY" ] && echo "✓ BTCPAY_API_KEY" || echo "○ No BTCPAY_API_KEY"
undefined
[ -n "$BTCPAY_URL" ] && echo "✓ BTCPAY_URL" || echo "○ No BTCPAY_URL" [ -n "$BTCPAY_API_KEY" ] && echo "✓ BTCPAY_API_KEY" || echo "○ No BTCPAY_API_KEY"
undefined

2. Run Provider Lifecycles

2. 运行提供商生命周期Skill

For each detected provider, invoke the full lifecycle skill:
ProviderSkillFallback
Stripe
/stripe
/check-stripe
if quick audit
Bitcoin
/bitcoin
/check-bitcoin
if quick audit
Lightning
/lightning
/check-lightning
if quick audit
BTCPay
/check-btcpay
N/A (audit only)
Each skill produces prioritized findings (P0-P3).
针对每个检测到的提供商,调用完整的生命周期Skill:
提供商Skill备选方案
Stripe
/stripe
若为快速审计则用
/check-stripe
Bitcoin
/bitcoin
若为快速审计则用
/check-bitcoin
Lightning
/lightning
若为快速审计则用
/check-lightning
BTCPay
/check-btcpay
无(仅审计)
每个Skill会生成按优先级划分的检查结果(P0-P3)。

3. Consolidate Findings

3. 整合检查结果

Merge all provider findings into unified report:
markdown
undefined
将所有提供商的检查结果合并为统一报告:
markdown
undefined

Unified Payment Audit

统一支付审计报告

P0: Critical (Cross-Provider)

P0:严重(跨提供商)

  • [Stripe] Webhook signature not verified
  • [Bitcoin] Node unreachable
  • [Lightning] No inbound liquidity
  • [Stripe] Webhook签名未验证
  • [Bitcoin] 节点无法连接
  • [Lightning] 无入站流动性

P1: Essential

P1:重要

  • [Stripe] No customer portal
  • [Lightning] Watchtower not configured
  • [BTCPay] Webhook URL uses HTTP
  • [Stripe] 未配置客户门户
  • [Lightning] 未配置瞭望塔
  • [BTCPay] Webhook URL使用HTTP

P2: Important

P2:次要

  • [Bitcoin] UTXO consolidation needed
  • [Lightning] Low outbound liquidity
  • [Stripe] Missing idempotency keys
  • [Bitcoin] 需要整合UTXO
  • [Lightning] 出站流动性不足
  • [Stripe] 缺少幂等键

P3: Nice to Have

P3:优化项

  • [All] Add unified payment analytics
undefined
  • [所有] 添加统一支付分析功能
undefined

4. Execute Fixes

4. 执行修复

Fix in priority order across all providers:
  1. P0 first — Any provider's P0 blocks payment acceptance
  2. Dependency chains — Lightning depends on Bitcoin node; fix Bitcoin first
  3. Cross-provider issues — Unified invoice tracking, reconciliation
Delegate code fixes to Codex:
bash
codex exec --full-auto "Fix [issue]. Provider: [stripe|bitcoin|lightning]. \
File: [path]. Follow pattern in [ref]. Verify: pnpm typecheck" \
--output-last-message /tmp/codex-fix.md 2>/dev/null
按优先级顺序跨所有提供商执行修复:
  1. 优先处理P0 —— 任何提供商的P0问题都会阻止支付接收
  2. 依赖链修复 —— Lightning依赖Bitcoin节点;先修复Bitcoin问题
  3. 跨提供商问题 —— 统一发票跟踪、对账
将代码修复任务委托给Codex:
bash
codex exec --full-auto "Fix [issue]. Provider: [stripe|bitcoin|lightning]. \
File: [path]. Follow pattern in [ref]. Verify: pnpm typecheck" \
--output-last-message /tmp/codex-fix.md 2>/dev/null

5. Verify All Flows

5. 验证所有流程

Test each provider end-to-end:
Stripe:
bash
undefined
端到端测试每个提供商:
Stripe:
bash
undefined

Create test checkout, complete with 4242...4242, verify webhook

创建测试结账会话,使用4242...4242完成支付,验证Webhook

stripe trigger checkout.session.completed

**Bitcoin:**
```bash
stripe trigger checkout.session.completed

**Bitcoin:**
```bash

Generate address, send testnet coins, verify confirmation tracking

生成地址,发送测试网代币,确认跟踪到确认信息

bitcoin-cli -testnet getnewaddress

**Lightning:**
```bash
bitcoin-cli -testnet getnewaddress

**Lightning:**
```bash

Create invoice, pay from another node, verify settlement

创建发票,从其他节点支付,验证结算

lncli --network=testnet addinvoice --amt=1000 --memo="Test"

Don't declare done until all active providers pass verification.
lncli --network=testnet addinvoice --amt=1000 --memo="Test"

所有活跃提供商验证通过后才算完成。

Output Format

输出格式

markdown
undefined
markdown
undefined

Payment Infrastructure Status

支付基础设施状态

Active Providers

活跃提供商

  • Stripe: Configured
  • Bitcoin: Configured (testnet)
  • Lightning: Configured (LND)
  • BTCPay: Not detected
  • Stripe:已配置
  • Bitcoin:已配置(测试网)
  • Lightning:已配置(LND)
  • BTCPay:未检测到

Findings Summary

检查结果汇总

ProviderP0P1P2P3
Stripe1231
Bitcoin0122
Lightning1213
Total2566
提供商P0P1P2P3
Stripe1231
Bitcoin0122
Lightning1213
总计2566

Fix Order

修复顺序

  1. [P0] Stripe webhook verification
  2. [P0] Lightning inbound liquidity
  3. [P1] Bitcoin fee estimation ...
  1. [P0] Stripe Webhook验证
  2. [P0] Lightning入站流动性
  3. [P1] Bitcoin手续费估算 ...

Verification Status

验证状态

  • Stripe: PASSED
  • Bitcoin: PASSED
  • Lightning: PENDING (waiting for channel open)
  • Stripe:已通过
  • Bitcoin:已通过
  • Lightning:待处理(等待通道开通)

Next Steps

下一步操作

Run
/fix-stripe
to address Stripe P0.
undefined
运行
/fix-stripe
解决Stripe的P0问题。
undefined

What You Get

最终成果

When complete:
  • All payment providers audited
  • Unified findings prioritized
  • Fixes implemented across providers
  • End-to-end verification per provider
  • Clear status and next steps
User can:
  • Accept payments via any configured provider
  • See unified payment health status
  • Run provider-specific skills for deeper work
完成后,你将获得:
  • 所有支付提供商已完成审计
  • 统一的优先级检查结果
  • 跨提供商的修复已实施
  • 每个提供商的端到端验证已完成
  • 清晰的状态和下一步操作指引
用户可以:
  • 通过任何已配置的提供商接收支付
  • 查看统一的支付健康状态
  • 运行提供商专属Skill进行深度操作

Related

相关Skill

  • /stripe
    - Stripe lifecycle
  • /bitcoin
    - Bitcoin lifecycle
  • /lightning
    - Lightning lifecycle
  • /check-payments
    - Multi-provider audit (no fixes)
  • /groom
    - Full backlog grooming
  • /stripe
    - Stripe生命周期管理
  • /bitcoin
    - Bitcoin生命周期管理
  • /lightning
    - Lightning生命周期管理
  • /check-payments
    - 多提供商审计(无修复)
  • /groom
    - 完整待办事项梳理