# Phase Handover — Payment Frontend (payment-frontend)

**Completed:** 2026-07-27  
**Service:** Torbat Pay — Enterprise Payment Platform  
**Backend version at handover:** 0.14.5.0 (phases 14.0–14.5)

## Summary

Full MVP admin portal for Torbat Pay delivered under `frontend/modules/payment/` and `frontend/app/payment/**`. Persian labels, real API wiring via BFF to port 8012, recharts on dashboard/KPIs.

## Deliverables

- 26 feature modules under `modules/payment/features/`
- Thin Next.js app routes with loading/error boundaries
- BFF `app/api/payment/[...path]/route.ts` (Idempotency-Key forwarded)
- `scripts/validate-payment-routes.mjs` + `npm run validate:payment`
- Apps catalog entry: Torbat Pay → `/payment/hub`
- Docker env: `NEXT_PUBLIC_PAYMENT_API_URL`, `PAYMENT_SERVICE_URL`
- Snapshots/docs: `payment-frontend.yaml`, architecture + validation reports

## Checkout session mapping

`PaymentRequest` detail page (`/payment/requests/[id]`) is the checkout session view — cancel, verify, redirect URL display.

## Stop boundary

**Do not implement 14.6+ UI** (refunds, splits, subscriptions) until backend phases complete.

## Next backend phase

`payment-14.6` Refunds & Reversals — frontend remains list/read for MVP until explicitly scoped.

## Verification

```bash
cd frontend
npm run validate:payment
npm run typecheck
```

## References

- [payment-frontend-architecture.md](../../frontend/docs/payment-frontend-architecture.md)
- [payment-frontend-validation-report.md](../../frontend/docs/payment-frontend-validation-report.md)
- [service-snapshots/payment-frontend.yaml](../service-snapshots/payment-frontend.yaml)
- [service-snapshots/payment.yaml](../service-snapshots/payment.yaml)
