Để AIlàm giúp bạn.

Bạn là lập trình viên của tôi. Hãy giúp tôi nhận thanh toán tiền mã hóa trên website bằng blockwallets (khách trả bằng USDT, USDC, BTC và 14 coin khác; tôi được ghi có theo đô la Mỹ).

## Về tôi
- Website của tôi được xây bằng: Tôi không chắc. Hãy xem dự án của tôi trước, cho tôi biết nó được xây bằng gì, rồi hãy bắt đầu.
- Cách tôi muốn nhận tiền: Tạo hóa đơn khi khách thanh toán và chuyển khách đến trang thanh toán của blockwallets; khi tiền đến, blockwallets gọi máy chủ của tôi và tôi đánh dấu đơn hàng đã thanh toán rồi giao hàng.
- Tôi không phải lập trình viên. Ở mỗi bước, hãy cho tôi biết bạn đã sửa những tệp nào và tôi cần làm gì (ví dụ để biến môi trường ở đâu). Đừng thay đổi quá nhiều cùng lúc.
- AGENTS.md ở thư mục gốc dự án chứa các quy tắc tích hợp blockwallets; hãy đọc nó trước, và đọc https://blockwallets.io/llms-full.txt để biết chi tiết.

## Đọc tài liệu trước; đừng đoán API theo trí nhớ
- Tài liệu tích hợp đầy đủ (Markdown): https://blockwallets.io/llms-full.txt
- Quy tắc tích hợp và các lỗi thường gặp: https://blockwallets.io/agents.md
- Nếu website đã dùng Cryptomus, NOWPayments hoặc Coinbase Commerce, hãy chuyển sang API tương thích tương ứng thay vì viết lại: https://blockwallets.io/docs/migrate.md?lang=en
- Nếu bạn không mở được liên kết, hãy nói với tôi và tôi sẽ dán nội dung.

## Các điểm chính (nơi tích hợp thường sai)
1. Mọi endpoint đều là POST + JSON trên https://blockwallets.io. Header: merchant = UUID của merchant, sign = md5(base64(nội dung yêu cầu) + API key). Hãy ký đúng chuỗi JSON bạn gửi; không tuần tự hóa lại sau khi ký.
2. Tạo hóa đơn bằng POST /v1/payment. Bắt buộc: amount (chuỗi có tối đa hai chữ số thập phân, ví dụ "42.00"), currency ("USD"), order_id (mã đơn hàng của tôi: chữ cái, chữ số, - và _, tối đa 100 ký tự). Truyền thêm url_callback (URL webhook) và url_success (nơi khách quay lại sau khi trả). Chuyển hướng khách đến result.url.
3. Gọi lại với cùng order_id sẽ trả về cùng một hóa đơn, nên gửi lại là an toàn và không bao giờ tạo hóa đơn thứ hai.
4. Phải xác minh chữ ký webhook: phân tích JSON của webhook, bỏ trường sign, mã hóa lại phần còn lại theo cách PHP json_encode làm (gọn, giữ nguyên ký tự không phải ASCII, / được thoát thành \/), rồi md5(base64(đã mã hóa) + API key) phải bằng sign. Quên thoát / là lỗi phổ biến nhất.
5. Chỉ đánh dấu đơn đã thanh toán khi status là paid hoặc paid_over, và dùng payment_amount_usd. Cùng một webhook có thể đến nhiều lần: loại trùng theo uuid + status. Sau khi xử lý xong, hãy trả về mã trạng thái 2xx.
6. Để merchant ID và API key trong biến môi trường (ví dụ BW_MERCHANT, BW_API_KEY); không bao giờ viết cứng trong code hay commit chúng. Hãy thêm tên miền của URL webhook vào “Tên miền website” ở trang “Nhà phát triển › Tích hợp & khóa” của trang quản trị trước.
7. Hãy làm cho mọi thứ chạy được bằng thông tin xác thực Test trước (testnet, không có tiền thật); chỉ chuyển sang Live sau khi tôi xác nhận.

## Khi xong, hãy kiểm tra từng mục và báo kết quả cho tôi
- [ ] Tạo một hóa đơn thử bằng thông tin xác thực Test và lấy liên kết trang thanh toán (result.url)
- [ ] Mở trang thanh toán và bấm “Mô phỏng thanh toán” → đủ số tiền
- [ ] Máy chủ của tôi nhận được webhook với status paid và chữ ký xác minh đúng
- [ ] Đơn hàng tương ứng được đánh dấu đã thanh toán
- [ ] Cùng webhook đó đến lần nữa (gửi lại từ “Nhà phát triển › Nhật ký webhook” của trang quản trị, hoặc POST /v1/payment/resend) không giao hàng hai lần

Nếu mục nào không đạt, hãy cho tôi biết nó vướng ở đâu và thông báo lỗi chính xác trước khi sửa thêm bất cứ thứ gì.