/payments

Unified payment lifecycle. Audit, fix, verify—all providers, one 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.

Branching

Before making code changes:

git checkout -b fix/payments-$(date +%Y%m%d)

Configuration-only changes (env vars, dashboard settings) don't require a branch.

Process

1. Detect Active Providers

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"

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"

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"

BTCPay

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

2. Run Provider Lifecycles

For each detected provider, invoke the full lifecycle skill:

Provider Skill Fallback

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).

3. Consolidate Findings

Merge all provider findings into unified report:

Unified Payment Audit

P0: Critical (Cross-Provider)

• [Stripe] Webhook signature not verified
• [Bitcoin] Node unreachable
• [Lightning] No inbound liquidity

P1: Essential

• [Stripe] No customer portal
• [Lightning] Watchtower not configured
• [BTCPay] Webhook URL uses HTTP

P2: Important

• [Bitcoin] UTXO consolidation needed
• [Lightning] Low outbound liquidity
• [Stripe] Missing idempotency keys

P3: Nice to Have

• [All] Add unified payment analytics

4. Execute Fixes

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:

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

Test each provider end-to-end:

Stripe:

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

stripe trigger checkout.session.completed

Bitcoin:

Generate address, send testnet coins, verify confirmation tracking

bitcoin-cli -testnet getnewaddress

Lightning:

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.

Output Format

Payment Infrastructure Status

Active Providers

• Stripe: Configured
• Bitcoin: Configured (testnet)
• Lightning: Configured (LND)
• BTCPay: Not detected

Findings Summary

Fix Order

1. [P0] Stripe webhook verification
2. [P0] Lightning inbound liquidity
3. [P1] Bitcoin fee estimation ...

Verification Status

• Stripe: PASSED
• Bitcoin: PASSED
• Lightning: PENDING (waiting for channel open)

Next Steps

Run /fix-stripe to address Stripe P0.

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

Related

• /stripe

• Stripe lifecycle

• /bitcoin

• Bitcoin lifecycle

• /lightning

• Lightning lifecycle

• /check-payments

• Multi-provider audit (no fixes)

• /groom

• Full backlog grooming