# docs/service-snapshots/payment-frontend.yaml

schema_version: 1
snapshot_version: 1

service_name: payment
layer: frontend
commercial_product: Torbat Pay
backend_version: "0.14.5.0"
current_phase: payment-frontend
last_completed_phase: payment-frontend
next_phase: payment-14.6
stop_boundary: MVP 14.0–14.5 (no refunds/splits UI)

completed_phases:
  - payment-frontend

module_path: frontend/modules/payment
bff_path: frontend/app/api/payment/[...path]/route.ts
app_routes_prefix: /payment
route_count: 26

env_vars:
  - NEXT_PUBLIC_PAYMENT_API_URL
  - PAYMENT_SERVICE_URL

apps_catalog:
  id: payment
  href: /payment/hub
  status: available

features:
  - hub
  - dashboard
  - overview
  - kpis
  - transactions
  - transactionDetail
  - ledger
  - psp
  - gatewayHealth
  - providers
  - merchants
  - merchantDetail
  - merchantApprovals
  - requests
  - requestDetail
  - callbacks
  - verification
  - audit
  - bundles
  - featureToggles
  - capabilities
  - settings
  - metrics
  - monitoring
  - apiExplorer
  - openapi

api_client: frontend/modules/payment/services/payment-api.ts
real_backend_only: true
mock_data: false

documentation:
  - docs/payment-roadmap.md
  - frontend/docs/payment-frontend-architecture.md
  - frontend/docs/payment-frontend-validation-report.md
  - docs/phase-handover/phase-payment-frontend.md
  - docs/service-snapshots/payment.yaml

open_todos:
  - payment-14.6+ Refunds & Reversals UI (explicitly out of scope)
  - payment-14.7+ Splits UI (explicitly out of scope)
  - Dedicated GET /callback-logs endpoint when backend exposes list API
  - Fine-grained permission gating per screen from identity membership

last_handover_reference: docs/phase-handover/phase-payment-frontend.md
last_updated: "2026-07-27"
