# PayXea Customer

Merchant-facing integration assets for PayXea: hosted checkout UI, payment result pages, and a local merchant demo that talks to **payxea_api**.

**Copyright © 2024–2026 [SOWDREAM TECH LIMITED](LICENSE)** (Company Registration No. HE 449172). Proprietary and confidential. See [LICENSE](LICENSE) and [NOTICE](NOTICE).

## Contents

| Path | Purpose |
|------|---------|
| `checkout/` | Hosted checkout page and `payxea-checkout-hosted.js` |
| `merchant-demo/` | Local demo server, session creation, payout sample |
| `pay/` | Success, cancel, and error redirect pages |
| `tools/` | Build helpers for checkout assets |
| `docs/` | Integration notes |

## Quick start (merchant demo)

1. Copy `.env.example` to `.env` and set `PAYXEA_API_KEY`, redirect URLs, and API base.
2. From `merchant-demo/`, run the dev server (see `dev_server.py`).
3. Open the demo in your browser on the configured port (default `PAYXEA_DEMO_PORT=3001`).

Configuration for checkout expiry is synced via `merchant-demo/sync_checkout_config.py` into `checkout/checkout-config.json`.

## Related repositories

- **payxea_api** — FastAPI backend and checkout session APIs
- **payxea_dashboard** — Merchant, agent, and admin dashboards