ให้ AIต่อให้เสร็จ

คุณคือนักพัฒนาของฉัน ช่วยฉันรับชำระเงินคริปโตบนเว็บไซต์ด้วย blockwallets (ลูกค้าจ่ายด้วย USDT, USDC, BTC และเหรียญอื่นอีก 14 เหรียญ ฉันได้รับเป็นดอลลาร์สหรัฐ)

## เกี่ยวกับฉัน
- เว็บไซต์ของฉันสร้างด้วย: ฉันไม่แน่ใจ ช่วยดูโปรเจกต์ของฉันก่อน บอกว่าสร้างด้วยอะไร แล้วค่อยเริ่ม
- ฉันต้องการรับเงินแบบ: สร้างใบแจ้งหนี้ตอนชำระเงินและส่งลูกค้าไปที่หน้าชำระเงินของ blockwallets เมื่อเงินเข้า blockwallets จะเรียกเซิร์ฟเวอร์ของฉัน แล้วฉันทำเครื่องหมายคำสั่งซื้อว่าชำระแล้วและจัดส่ง
- ฉันไม่ใช่โปรแกรมเมอร์ ในทุกขั้นตอน บอกว่าคุณแก้ไฟล์ไหนและฉันต้องทำอะไร (เช่นวางตัวแปรสภาพแวดล้อมที่ไหน) อย่าเปลี่ยนมากเกินไปในครั้งเดียว
- AGENTS.md ที่รากโปรเจกต์มีกฎการเชื่อมต่อ blockwallets ให้อ่านก่อน และอ่าน https://blockwallets.io/llms-full.txt สำหรับรายละเอียด

## อ่านเอกสารก่อน อย่าเดา API จากความจำ
- เอกสารการเชื่อมต่อฉบับเต็ม (Markdown): https://blockwallets.io/llms-full.txt
- กฎการเชื่อมต่อและข้อผิดพลาดที่พบบ่อย: https://blockwallets.io/agents.md
- หากเว็บไซต์ใช้ Cryptomus, NOWPayments หรือ Coinbase Commerce อยู่แล้ว ให้เปลี่ยนไปใช้ API ที่เข้ากันได้ตัวที่ตรงกันแทนการเขียนใหม่: https://blockwallets.io/docs/migrate.md?lang=en
- หากเปิดลิงก์ไม่ได้ บอกฉัน แล้วฉันจะวางเนื้อหาให้

## ประเด็นสำคัญ (จุดที่การเชื่อมต่อมักผิดพลาด)
1. ทุก endpoint เป็น POST + JSON บน https://blockwallets.io เฮดเดอร์: merchant = UUID ของ merchant, sign = md5(base64(เนื้อหาคำขอ) + API key) ให้เซ็นสตริง JSON ที่ส่งจริงเป๊ะ ห้าม serialize ใหม่หลังเซ็น
2. สร้างใบแจ้งหนี้ด้วย POST /v1/payment ฟิลด์ที่ต้องมี: amount (สตริงที่มีทศนิยมไม่เกินสองตำแหน่ง เช่น "42.00"), currency ("USD"), order_id (เลขคำสั่งซื้อของฉัน: ตัวอักษร ตัวเลข - และ _ ไม่เกิน 100 ตัวอักษร) ส่ง url_callback (URL Webhook) และ url_success (ที่ที่ลูกค้ากลับมาหลังจ่าย) ด้วย แล้วส่งลูกค้าไปที่ result.url
3. การเรียกซ้ำด้วย order_id เดิมจะได้ใบแจ้งหนี้เดิม จึงลองซ้ำได้อย่างปลอดภัยและไม่สร้างใบแจ้งหนี้ใบที่สอง
4. ต้องตรวจลายเซ็นของ Webhook: parse JSON ของ Webhook ตัดฟิลด์ sign ออก แล้วเข้ารหัสส่วนที่เหลือใหม่แบบ PHP json_encode (กะทัดรัด, อักขระที่ไม่ใช่ ASCII คงไว้, / ถูก escape เป็น \/) จากนั้น md5(base64(encoded) + API key) ต้องเท่ากับ sign การลืม escape / เป็นข้อผิดพลาดที่พบบ่อยที่สุด
5. ทำเครื่องหมายคำสั่งซื้อว่าชำระแล้วก็ต่อเมื่อ status เป็น paid หรือ paid_over โดยใช้ payment_amount_usd Webhook เดียวกันอาจมาถึงมากกว่าหนึ่งครั้ง: กรองซ้ำด้วย uuid + status ตอบด้วยสถานะ 2xx เมื่อจัดการแล้ว
6. เก็บ merchant ID และ API key ไว้ในตัวแปรสภาพแวดล้อม (เช่น BW_MERCHANT, BW_API_KEY) ห้ามเขียนตายตัวในโค้ดหรือ commit เข้า repository ก่อนอื่นให้เพิ่มโดเมนของ URL Webhook ที่ “โดเมนเว็บไซต์” ในหน้า “นักพัฒนา › การเชื่อมต่อและคีย์” ของแดชบอร์ด
7. ทำให้ทุกอย่างทำงานด้วยข้อมูลรับรอง Test ก่อน (เทสต์เน็ต ไม่มีเงินจริง) สลับไป Live เมื่อฉันยืนยันแล้วเท่านั้น

## เมื่อเสร็จแล้ว ตรวจทีละข้อและบอกผลให้ฉัน
- [ ] สร้างใบแจ้งหนี้ทดสอบด้วยข้อมูลรับรอง Test และรับลิงก์หน้าชำระเงิน (result.url)
- [ ] เปิดหน้าชำระเงินแล้วกด “จำลองการชำระเงิน” → เต็มจำนวน
- [ ] เซิร์ฟเวอร์ของฉันได้รับ Webhook ที่ status เป็น paid และลายเซ็นผ่านการตรวจ
- [ ] คำสั่งซื้อที่ตรงกันถูกทำเครื่องหมายว่าชำระแล้ว
- [ ] Webhook เดิมที่มาซ้ำ (ส่งซ้ำจาก “นักพัฒนา › บันทึก Webhook” ในแดชบอร์ด หรือ POST /v1/payment/resend) ไม่ทำให้จัดส่งซ้ำ

หากข้อใดไม่ผ่าน บอกว่าติดตรงไหนพร้อมข้อความผิดพลาดที่ตรงตัว ก่อนจะแก้อย่างอื่น