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
undefinedbash
undefinedStripe
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"
undefined2. Run Provider Lifecycles
2. 运行提供商生命周期Skill
For each detected provider, invoke the full lifecycle skill:
| Provider | Skill | Fallback |
|---|---|---|
| Stripe | | |
| Bitcoin | | |
| Lightning | | |
| BTCPay | | N/A (audit only) |
Each skill produces prioritized findings (P0-P3).
针对每个检测到的提供商,调用完整的生命周期Skill:
| 提供商 | Skill | 备选方案 |
|---|---|---|
| Stripe | | 若为快速审计则用 |
| Bitcoin | | 若为快速审计则用 |
| Lightning | | 若为快速审计则用 |
| BTCPay | | 无(仅审计) |
每个Skill会生成按优先级划分的检查结果(P0-P3)。
3. Consolidate Findings
3. 整合检查结果
Merge all provider findings into unified report:
markdown
undefined将所有提供商的检查结果合并为统一报告:
markdown
undefinedUnified 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- [所有] 添加统一支付分析功能
undefined4. Execute Fixes
4. 执行修复
Fix in priority order across all providers:
- P0 first — Any provider's P0 blocks payment acceptance
- Dependency chains — Lightning depends on Bitcoin node; fix Bitcoin first
- 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按优先级顺序跨所有提供商执行修复:
- 优先处理P0 —— 任何提供商的P0问题都会阻止支付接收
- 依赖链修复 —— Lightning依赖Bitcoin节点;先修复Bitcoin问题
- 跨提供商问题 —— 统一发票跟踪、对账
将代码修复任务委托给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/null5. Verify All Flows
5. 验证所有流程
Test each provider end-to-end:
Stripe:
bash
undefined端到端测试每个提供商:
Stripe:
bash
undefinedCreate test checkout, complete with 4242...4242, verify webhook
创建测试结账会话,使用4242...4242完成支付,验证Webhook
stripe trigger checkout.session.completed
**Bitcoin:**
```bashstripe trigger checkout.session.completed
**Bitcoin:**
```bashGenerate address, send testnet coins, verify confirmation tracking
生成地址,发送测试网代币,确认跟踪到确认信息
bitcoin-cli -testnet getnewaddress
**Lightning:**
```bashbitcoin-cli -testnet getnewaddress
**Lightning:**
```bashCreate 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
undefinedmarkdown
undefinedPayment Infrastructure Status
支付基础设施状态
Active Providers
活跃提供商
- Stripe: Configured
- Bitcoin: Configured (testnet)
- Lightning: Configured (LND)
- BTCPay: Not detected
- Stripe:已配置
- Bitcoin:已配置(测试网)
- Lightning:已配置(LND)
- BTCPay:未检测到
Findings Summary
检查结果汇总
| Provider | P0 | P1 | P2 | P3 |
|---|---|---|---|---|
| Stripe | 1 | 2 | 3 | 1 |
| Bitcoin | 0 | 1 | 2 | 2 |
| Lightning | 1 | 2 | 1 | 3 |
| Total | 2 | 5 | 6 | 6 |
| 提供商 | P0 | P1 | P2 | P3 |
|---|---|---|---|---|
| Stripe | 1 | 2 | 3 | 1 |
| Bitcoin | 0 | 1 | 2 | 2 |
| Lightning | 1 | 2 | 1 | 3 |
| 总计 | 2 | 5 | 6 | 6 |
Fix Order
修复顺序
- [P0] Stripe webhook verification
- [P0] Lightning inbound liquidity
- [P1] Bitcoin fee estimation ...
- [P0] Stripe Webhook验证
- [P0] Lightning入站流动性
- [P1] Bitcoin手续费估算 ...
Verification Status
验证状态
- Stripe: PASSED
- Bitcoin: PASSED
- Lightning: PENDING (waiting for channel open)
- Stripe:已通过
- Bitcoin:已通过
- Lightning:待处理(等待通道开通)
Next Steps
下一步操作
Run to address Stripe P0.
/fix-stripeundefined运行解决Stripe的P0问题。
/fix-stripeundefinedWhat 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 lifecycle
/stripe - - Bitcoin lifecycle
/bitcoin - - Lightning lifecycle
/lightning - - Multi-provider audit (no fixes)
/check-payments - - Full backlog grooming
/groom
- - Stripe生命周期管理
/stripe - - Bitcoin生命周期管理
/bitcoin - - Lightning生命周期管理
/lightning - - 多提供商审计(无修复)
/check-payments - - 完整待办事项梳理
/groom