# เชื่อมต่อด้วย AI · blockwallets

> เพิ่มการรับชำระคริปโตของ blockwallets โดยไม่ต้องเขียนโค้ดเอง: เลือกเว็บไซต์และเครื่องมือ AI ของคุณ คัดลอกพรอมต์ที่สร้างให้ไปใส่ใน Claude Code, Codex, Cursor หรือ ChatGPT แล้วมันจะเชื่อมต่อจากเอกสารและตรวจงานของตัวเอง
>
> HTML: https://blockwallets.io/docs/ai?lang=th · English: https://blockwallets.io/docs/ai.md?lang=en

## พรอมต์สากล

```text
ช่วยฉันรับชำระเงินคริปโตบนเว็บไซต์ด้วย blockwallets (ลูกค้าจ่ายด้วย USDT, USDC, BTC และอื่น ๆ ฉันได้รับเป็นดอลลาร์สหรัฐ)

1. อ่านเอกสารก่อน อย่าเดา API: https://blockwallets.io/llms-full.txt (เอกสารฉบับเต็ม) และ https://blockwallets.io/agents.md (กฎการเชื่อมต่อ ข้อผิดพลาดที่พบบ่อย รายการตรวจรับ) หากเปิดไม่ได้ บอกฉัน
2. ดูโปรเจกต์ของฉัน บอกว่าสร้างด้วยอะไรและวางแผนเชื่อมต่ออย่างไร แล้วรอให้ฉันตกลง
3. ค่าเริ่มต้นคือ “สร้างใบแจ้งหนี้และส่งไปหน้าชำระเงิน + Webhook” ตรวจลายเซ็น Webhook เสมอ และกรอง Webhook ซ้ำเพราะ Webhook เดียวกันอาจมาถึงสองครั้ง
4. เก็บ merchant ID และ API key ไว้ในตัวแปรสภาพแวดล้อม และทำให้ใช้งานได้ด้วยข้อมูลรับรอง Test บนเทสต์เน็ตก่อน
5. เมื่อเสร็จ ไล่ตรวจรายการตรวจรับใน agents.md ทีละข้อและบอกผลแต่ละข้อ

ฉันไม่ใช่โปรแกรมเมอร์: ในทุกขั้นตอน บอกว่าคุณแก้อะไรและฉันต้องทำอะไร
```

## บอกเรา เกี่ยวกับเว็บไซต์ของคุณ

ไม่แน่ใจ? เลือก “อื่น ๆ / ไม่แน่ใจ” แล้ว AI จะดูโปรเจกต์ของคุณก่อน

- เว็บไซต์ของคุณสร้างด้วยอะไร: WordPress / WooCommerce · PHP · Node.js / Next.js · Python · Go · Java · อื่น ๆ / ไม่แน่ใจ
- คุณต้องการรับเงินแบบไหน:
  - ส่งไปหน้าชำระเงิน: สร้างใบแจ้งหนี้ตอนชำระเงิน เมื่อจ่ายแล้วเราแจ้งเซิร์ฟเวอร์ของคุณ คำสั่งซื้อจัดส่งเอง
  - ที่อยู่ฝากเงินคงที่ของผู้ใช้แต่ละคน: ผู้ใช้แต่ละคนมีที่อยู่ถาวร เติมเงินจำนวนเท่าไรก็ได้ เมื่อไรก็ได้
  - ลิงก์ชำระเงิน (ไม่ต้องเขียนโค้ด): สร้างลิงก์ในแดชบอร์ดแล้วแชร์ AI เพียงเพิ่มปุ่ม

ลิงก์ชำระเงินไม่ต้องเขียนโค้ด: แดชบอร์ด → “การรับเงิน › ลิงก์รับชำระ” → ใส่จำนวนเงิน → สร้าง แล้วแชร์ลิงก์ AI เพียงใส่ปุ่มบนเว็บไซต์ของคุณ

## คุณใช้ AI ตัวไหน?

- **Claude Code / Codex**: AI ที่แก้โค้ดและรันคำสั่งให้ ง่ายที่สุด
  - เปิดเทอร์มินัลในโฟลเดอร์โปรเจกต์เว็บไซต์ของคุณ แล้วบันทึกกฎการเชื่อมต่อเป็น AGENTS.md:
  - `curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md`
  - Codex อ่าน AGENTS.md เอง ส่วน Claude Code ให้รันเพิ่ม:
  - `echo '@AGENTS.md' >> CLAUDE.md`
  - จากนั้นวางพรอมต์จากขั้นที่ 3
  - คุณติดตั้งเซิร์ฟเวอร์ MCP ของ blockwallets เพิ่มได้ เพื่อให้ AI ค้นเอกสารและสร้างใบแจ้งหนี้ทดสอบได้โดยตรง https://blockwallets.io/docs/mcp?lang=th
- **Cursor / Windsurf / Copilot**: AI ในโปรแกรมแก้โค้ดของคุณ
  - วาง AGENTS.md ไว้ที่รากโปรเจกต์เช่นกัน (Cursor อ่านให้อัตโนมัติ):
  - `curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md`
  - สลับเป็นโหมด Agent แล้ววางพรอมต์
  - คุณติดตั้งเซิร์ฟเวอร์ MCP ของ blockwallets เพิ่มได้ เพื่อให้ AI ค้นเอกสารและสร้างใบแจ้งหนี้ทดสอบได้โดยตรง https://blockwallets.io/docs/mcp?lang=th
- **ChatGPT / Claude (เว็บ)**: แชตอย่างเดียว คุณวางโค้ดลงเว็บไซต์เอง
  - วางพรอมต์ในแชตใหม่ หรือใช้ “เปิดใน ChatGPT / Claude” ด้านล่าง
  - หากบอกว่าเปิดลิงก์ไม่ได้ ให้เปิด https://blockwallets.io/llms-full.txt เลือกทั้งหมด คัดลอก แล้ววางเข้าไปด้วย
  - AI จะให้โค้ดที่สมบูรณ์และบอกว่าต้องวางที่ไหน ทำตามทีละขั้น เครื่องมือที่แก้โค้ดให้ (Claude Code, Codex, Cursor) ช่วยลดการคัดลอกได้มาก
- **AI อื่น**: Gemini, Copilot แชต และอื่น ๆ
  - วางพรอมต์ หากเปิดหน้าเว็บไม่ได้ ให้วางเนื้อหาของ llms-full.txt เพิ่มด้วย

## คัดลอก พรอมต์

จะอัปเดตตามที่คุณเลือกด้านบน พร้อมลิงก์เอกสาร จุดที่มักพลาด และรายการตรวจรับ

ตัวอย่าง: อื่น ๆ / ไม่แน่ใจ + ส่งไปหน้าชำระเงิน + Claude Code / Codex

```text
คุณคือนักพัฒนาของฉัน ช่วยฉันรับชำระเงินคริปโตบนเว็บไซต์ด้วย 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) ไม่ทำให้จัดส่งซ้ำ

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

### เมื่อ AI ทำเสร็จ ให้ตรวจสิ่งเหล่านี้

**ส่งไปหน้าชำระเงิน**

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

**ที่อยู่ฝากเงินคงที่ของผู้ใช้แต่ละคน**

1. เปิดที่อยู่สำหรับผู้ใช้ทดสอบด้วยข้อมูลรับรอง Test และรับที่อยู่กับลิงก์หน้าฝากเงิน
2. ส่ง Webhook ตัวอย่างด้วย POST /v1/test-webhook/wallet
3. เซิร์ฟเวอร์ของฉันได้รับ Webhook ที่ type เป็น wallet และลายเซ็นผ่านการตรวจ
4. ยอดคงเหลือของผู้ใช้คนนั้นเพิ่มขึ้นตาม payment_amount_usd
5. Webhook เดิมที่มาซ้ำไม่ทำให้บวกยอดซ้ำ

**ลิงก์ชำระเงิน (ไม่ต้องเขียนโค้ด)**

1. ปุ่มแสดงผลถูกต้องทั้งบนเดสก์ท็อปและมือถือ
2. ปุ่มเปิดลิงก์ชำระเงินของฉัน (ใช้ลิงก์ที่สร้างในโหมด Test ก่อน)
3. การกด “จำลองการชำระเงิน” ที่หน้าชำระเงินแสดงรายการชำระใน “การรับเงิน › รายการรับเงิน” ของแดชบอร์ด

## เมื่อ AI ติดขัด

- **ลายเซ็นตรวจไม่ผ่านสักที**: วางเนื้อหา Webhook ดิบใน[ตัวตรวจลายเซ็น](https://blockwallets.io/docs/sign?lang=th) จะแสดงทุกขั้นระหว่างทางและทำเครื่องหมายจุดแรกที่ต่างกัน บอก AI ของคุณตรง ๆ ว่าต่างกันตรงไหน
- **endpoint ตอบข้อผิดพลาด**: วางคำขอและการตอบกลับที่ตรงตัว (รวม message) ให้ AI ของคุณ เมื่อลายเซ็นผิด debug.body_base64 ในการตอบกลับ 401 คือข้อความที่เราเซ็น ให้ AI เทียบกับของตัวเอง
- **ไม่แน่ใจว่าติดตรงไหน**: ให้ AI ไล่ตรวจรายการตรวจรับตั้งแต่ข้อแรกทีละข้อ แล้วรายงานผลแต่ละข้อ “นักพัฒนา › บันทึก Webhook” ในแดชบอร์ดแสดงคำขอ Webhook ทุกครั้งและการตอบกลับของเซิร์ฟเวอร์คุณ

### สี่เรื่องที่ คุณต้องคอยดู

- **ให้ AI ใช้เฉพาะข้อมูลรับรอง Test**: merchant ID และ API key ของ Test ทำงานบนเทสต์เน็ต แม้รั่วไหลก็ย้ายเงินไม่ได้
- **อย่าเอา API key ของ Live ไปไว้ในแชต**: ใส่ API key ของ Live ในตัวแปรสภาพแวดล้อมของเซิร์ฟเวอร์ด้วยตัวเอง ห้ามวางในแชตหรือ commit เข้า repository
- **สำรองข้อมูลก่อนให้ AI แก้**: commit (git commit) หรือคัดลอกไฟล์เว็บไซต์ก่อนให้ AI เริ่ม เพื่อย้อนกลับได้
- **จ่ายเองสักครั้งก่อนใช้งานจริง**: หลังสลับเป็น Live ให้จ่ายจริงจำนวนน้อยผ่าน “ลองรับเงินหนึ่งรายการ” ที่หน้าแรกของแดชบอร์ด แล้วตรวจว่าคำสั่งซื้อถูกทำเครื่องหมายว่าชำระแล้วและยอดคงเหลือเข้ามา

## ไฟล์กฎ สำหรับเอเจนต์เขียนโค้ด

AGENTS.md รวมสาระสำคัญของการเชื่อมต่อ ข้อผิดพลาดที่พบบ่อย และรายการตรวจรับ วางไว้ที่รากโปรเจกต์: Codex และ Cursor อ่านให้อัตโนมัติ Claude Code นำเข้าด้วย @AGENTS.md

```sh
curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md
echo '@AGENTS.md' >> CLAUDE.md
```

- [กฎการเชื่อมต่อ (AGENTS.md)](https://blockwallets.io/agents.md)
- [สรุปหนึ่งหน้า](https://blockwallets.io/llms.txt)
- [เอกสารฉบับเต็ม](https://blockwallets.io/llms-full.txt)
- [หน้านี้ในรูปแบบ Markdown](https://blockwallets.io/docs/ai.md?lang=th)
- [เอกสารในรูปแบบ Markdown](https://blockwallets.io/docs.md?lang=th)
- [เซิร์ฟเวอร์ MCP](https://blockwallets.io/docs/mcp?lang=th)

## คำถาม และคำตอบ

### ถ้าเขียนโค้ดไม่เป็น เชื่อมต่อด้วย AI ได้จริงไหม?

สำหรับเว็บไซต์ส่วนใหญ่ ได้ AI เขียนโค้ดสร้างใบแจ้งหนี้และลายเซ็นจากเอกสาร คุณใส่ข้อมูลรับรองในตัวแปรสภาพแวดล้อมและไล่รายการตรวจรับในโหมดทดสอบ หากไม่อยากมีโค้ดเลย ใช้ลิงก์ชำระเงิน

### ควรใช้เครื่องมือ AI ตัวไหน?

เครื่องมือที่แก้โปรเจกต์และรันคำสั่งให้ง่ายที่สุด: Claude Code, Codex หรือ Cursor ChatGPT หรือ Claude บนเว็บก็ใช้ได้ แต่คุณต้องวางโค้ดลงเว็บไซต์เอง

### ควรให้ API key กับ AI ไหม?

เฉพาะข้อมูลรับรอง Test และให้ผ่านไฟล์สภาพแวดล้อม ไม่ใช่ในแชต API key ของ Live ใส่ในเซิร์ฟเวอร์ของคุณด้วยตัวเอง

### ลายเซ็น Webhook ตรวจไม่ผ่านสักที ทำอย่างไร?

ตัด sign ออก เข้ารหัสส่วนที่เหลือใหม่แบบ PHP json_encode และ escape / เป็น \/ วางเนื้อหา Webhook ดิบที่ /docs/sign เพื่อเทียบทุกขั้น แล้วบอก AI ว่าต่างกันตรงไหน

### AI บอกว่าเสร็จแล้ว ตรวจอย่างไร?

ไล่รายการตรวจรับ: สร้างใบแจ้งหนี้ทดสอบ จำลองการชำระเงิน ดูว่า Webhook ผ่านการตรวจลายเซ็น คำสั่งซื้อถูกทำเครื่องหมายว่าชำระแล้ว และส่ง Webhook เดิมซ้ำเพื่อยืนยันว่าไม่จัดส่งซ้ำ จ่ายจริงจำนวนน้อยก่อนใช้งานจริง