Service claw payment service

claw-payment-service

Rendered from .ai/manifests/ on every publish. Rules for this service: CLAUDE.md · guide: service guide.

Property	Value
Directory	apps/claw-payment-service
Port	4018
Database	postgresql
Test files	112 (vitest)
Internal packages	@claw/shared-auth, @claw/shared-constants, @claw/shared-entitlements, @claw/shared-rabbitmq, @claw/shared-types, @claw/shared-utilities

Persistence models

• BillingCustomer
• CheckoutSession
• FxQuote
• GatewayConfiguration
• GatewayPlanMapping
• IdempotencyRecord
• InboxEvent
• Invoice
• InvoiceDelivery
• InvoiceLine
• OutboxEvent
• PaymentMethod
• PaymentTransaction
• ProrationQuote
• ReconciliationDivergence
• ReconciliationRun
• Refund
• SeedExecution
• Subscription
• WebhookEvent

HTTP API (39)

Method	Route	Source
GET	/admin/billing/dashboard	billing-dashboard.controller.ts
GET	/admin/billing/dashboard/price-version-counts	billing-dashboard.controller.ts
POST	/admin/billing/reconciliation	reconciliation-admin.controller.ts
POST	/admin/billing/refunds	refund.controller.ts
GET	/admin/billing/refunds/refundable-transactions	refund.controller.ts
GET	/admin/billing/users/:userId/subscription	admin-user-billing.controller.ts
GET	/admin/payment-gateways	admin-gateway-config.controller.ts
PUT	/admin/payment-gateways/:gateway	admin-gateway-config.controller.ts
POST	/billing/checkout-sessions	checkout.controller.ts
GET	/billing/checkout-sessions/:id	checkout.controller.ts
POST	/billing/checkout-sessions/:id/complete-paymob	checkout.controller.ts
POST	/billing/checkout-sessions/:id/complete-paypal	checkout.controller.ts
POST	/billing/checkout-sessions/:id/complete-paypal-sdk	checkout.controller.ts
POST	/billing/credit-topup/checkout-sessions	credit-topup.controller.ts
GET	/billing/credit-topup/checkout-sessions/:id	credit-topup.controller.ts
GET	/billing/credit-topup/packages	credit-topup.controller.ts
GET	/billing/display-currency	public-display-currency.controller.ts
GET	/billing/gateways	checkout-gateways.controller.ts
GET	/billing/invoices	subscriptions.controller.ts
GET	/billing/invoices/:id/pdf	subscriptions.controller.ts
GET	/billing/me	subscriptions.controller.ts
POST	/billing/payment-method-setup-sessions	checkout.controller.ts
GET	/billing/payment-method-setup-sessions/:id	checkout.controller.ts
GET	/billing/payment-methods	subscriptions.controller.ts
DELETE	/billing/payment-methods/:id	subscriptions.controller.ts
GET	/billing/plans	checkout.controller.ts
DELETE	/billing/subscription	subscriptions.controller.ts
POST	/billing/subscription/cancel	subscriptions.controller.ts
POST	/billing/subscription/change/confirm	subscriptions.controller.ts
POST	/billing/subscription/change/quote	subscriptions.controller.ts
POST	/billing/subscription/resume	subscriptions.controller.ts
GET	/health	health.controller.ts
GET	/internal/payments/subscriptions/:id/status	internal-payments.controller.ts
GET	/internal/payments/transactions/:id/status	internal-payments.controller.ts
GET	/internal/payments/users/:userId/entitlement	internal-payments.controller.ts
POST	/payments/webhooks/paymob	paymob-webhook.controller.ts
POST	/payments/webhooks/paymob/card-token	paymob-webhook.controller.ts
POST	/payments/webhooks/paymob/transaction	paymob-webhook.controller.ts
POST	/payments/webhooks/paypal	paypal-webhook.controller.ts

Events (inferred from source; verify before a critical change)

• Publishes: log.server
• Consumes: billing.credit.topup_reversed, billing.credit.topup_succeeded, billing.payment.chargeback, billing.payment.refunded, billing.subscription.activated, billing.subscription.cancelled, billing.subscription.downgrade_scheduled, billing.subscription.downgraded, billing.subscription.expired, billing.subscription.past_due, billing.subscription.suspended, billing.subscription.upgraded