I. Gói Free của SePay làm được gì?

Webhook tự động — SePay thông báo với server khi nhận được tiền
API tra cứu giao dịch — chủ động gọi API để kiểm tra lịch sử, trạng thái đơn hàng
Giả lập giao dịch sandbox — test toàn bộ luồng mà không cần chuyển tiền thật
Hỗ trợ 51+ ngân hàng Việt Nam thông qua chuẩn VietQR của NAPAS
Giao dịch tiền ra miễn phí và không tính vào hạn mức hàng tháng
Gói free của sepay sẽ miễn phí 500 giao dịch mỗi tháng

II. Luồng thanh toán

III. Chuẩn bị

1. vào trang my.dev.sepay.vn đăng ký tài khoản

sau đó ib sepay qua zalo hoặc fb để xin kích hoạt tài khoản ib kèm mail tài khoản

2. cấu hình -> cấu hình chung -> tiền tố (mặc định là DH) có thể đổi để sepay phân

biệt giao dịch từ project với giao dịch thông thường

3. Lấy thông tin tài khoản demo

a. vào mục ngân hàng trên sidebar -> chọn kết nối tài khoản

- nếu không có ngân hàng của bạn chọn SMS Báo số dư để đăng ký

BANK_ACCOUNT=số_tài_khoản_demo
BANK_SHORT_NAME=TenNganHang # VD: Vietcombank

-> vào đây xem cho chuẩn bank name https://qr.sepay.vn/banks.json

b. vào tích hợp webhooks trên sidebar -> thêm webhooks

- Nhập tên webhook và "3. Gọi đến URL" nhập endpoint ở đây ví dụ

domain/api/sepay-hooks, những chỗ khác nhập hay không cũng được

-> chỗ endpoint này sẽ có hướng dẫn bên dưới sửa sau

c. khi chạy dự án backend tìm cách mở port ra ngoài để sepay có thể gửi request

tới được cách dễ nhất là dùng chức năng có sẵn của vscode
- mở terminal -> chọn icon port bên trái terminal

- nhập port backend đang chạy ví dụ 8080 -> đổi trạng thái sang pubic

- copy link vào lại mục webhook trên nhập link này vào kèm endpoint webhook

ví dụ: domain/api/sepay/hook

BANK_ACCOUNT=La Ngoc Hung
BANK_ACCOUNT_NUMBER=1234567
BANK_SHORT_NAME=BIDV

IV - Prompt vide code

== THÔNG TIN CẦN ĐIỀN ==
BANK_ACCOUNT=
BANK_ACCOUNT_NUMBER=
BANK_SHORT_NAME=
========================

Trước khi làm bất cứ điều gì, hãy đọc toàn bộ codebase hiện tại để hiểu:
- Stack công nghệ đang dùng (framework, database, cách tổ chức file)
- Cách các API hiện tại được viết (cấu trúc, naming convention, error handling)
- Cách frontend đang gọi API (fetch, axios, useFetch...)
- Cách quản lý state và environment variables

Sau khi đọc xong, hãy lập kế hoạch (plan) và trình bày những gì sẽ tạo/sửa trước khi viết bất kỳ dòng code nào. Đợi tôi xác nhận plan rồi mới bắt đầu code.

---

Tôi cần tích hợp thanh toán SePay (QR chuyển khoản) vào dự án này.

Backend — 3 endpoint:
1. POST /api/payment/create-qr
   - Nhận { orderId, amount }
   - Lưu đơn hàng vào database với status = "pending"
   - Build URL QR: https://qr.sepay.vn/img?acc={ACCOUNT_NUMBER}&bank={BANK_CODE}&amount={amount}&des={PAYMENT_PREFIX}-{orderId}
   - Trả về { qrUrl, orderId }

2. GET /api/payment/status/:orderId
   - Đọc trạng thái đơn hàng từ database
   - Trả về { orderId, status: "pending" | "paid", paidAmount? }

3. POST /webhook/sepay
   - Không cần xác thực token
   - Chỉ xử lý khi transferType === "in"
   - Kiểm tra id giao dịch đã xử lý chưa để tránh duplicate
   - Parse orderId từ trường content (tìm pattern {PAYMENT_PREFIX}-xxx)
   - Cập nhật status đơn hàng thành "paid", lưu paidAmount
   - Luôn trả HTTP 200 { success: true } dù có lỗi hay không — bắt buộc để SePay không retry

Frontend — 1 màn hình thanh toán:
- Gọi POST /api/payment/create-qr khi mount, nhận qrUrl hiển thị bằng thẻ <img>
- Hiện số tiền và orderId
- Polling GET /api/payment/status/:orderId mỗi 3 giây
- Khi status === "paid": dừng polling, ẩn QR, hiện "Thanh toán thành công ✓", redirect sau 3 giây
- Nếu sau 10 phút chưa thanh toán: dừng polling, hiện nút "Thử lại"
- Cleanup interval khi unmount

Hãy follow đúng convention và stack hiện tại của project. Thêm error handling và log cơ bản để dễ debug.