Skip to main content

เชื่อมต่อ Ko-fi

คู่มือนี้สำหรับสตรีมเมอร์ที่รับเงินผ่าน Ko-fi (เหมาะกับผู้ชมต่างชาติ — ไม่มี PromptPay) การเชื่อมต่อมี 2 ส่วน: สร้าง Webhook URL ในแอปแล้วนำไปวางใน Ko-fi และคัดลอก Verification Token จาก Ko-fi กลับมาวางในแอป — ต้องมีครบทั้งคู่ถึงจะรับโดเนทได้

สิ่งที่ต้องเตรียม​

  • บัญชี Ko-fi ที่ใช้งานจริง (ko-fi.com)
  • เปิด Donari และเข้าสู่หน้า Settings ได้
  • เบราว์เซอร์สำหรับล็อกอิน Ko-fi → More → API

ขั้นที่ 1 — สร้าง Webhook URL ในแอป​

  1. ในแอป ไปที่ Settings (sidebar) → แท็บ Connections
  2. หาส่วน ☕ Ko-fi
  3. กดปุ่ม สร้าง Webhook URL (Generate Webhook URL)
  4. แอปจะแสดง URL — กด Copy

:::warning URL แสดงครั้งเดียว Webhook URL จะโชว์เต็ม ๆ แค่ครั้งเดียว — copy ก่อนออกจากหน้านี้ ถ้าทำหาย ให้กด สร้างใหม่ (Regenerate) (ของเดิมจะถูก revoke ทันที — ต้องนำ URL ใหม่ไปวางใน Ko-fi) :::

ขั้นที่ 2 — วาง URL ใน Ko-fi​

  1. ล็อกอิน ko-fi.com → ไปที่ More → API
  2. วาง Webhook URL ที่ copy มาในช่อง Webhook URL → Save

ขั้นที่ 3 — คัดลอก Verification Token กลับมาวางในแอป​

  1. ยังอยู่ที่ Ko-fi → More → API กด "Advanced"
  2. คัดลอก Verification Token (รูปแบบ UUID เช่น 00000000-1111-2222-3333-444444444444)
  3. กลับมาที่แอป วาง token ในช่อง Verification Token → Save

:::danger ต้องมี Verification Token เสมอ ถ้าไม่ใส่ Verification Token โดเนทจะถูก ปฏิเสธทันที และ Ko-fi ไม่ retry — โดเนทนั้นหายเลย ทำขั้นนี้ให้ครบก่อนเปิดรับจริง :::

ขั้นที่ 4 — ทดสอบและตรวจสอบสถานะ​

  1. ที่ Ko-fi → More → API กด Send Test เพื่อส่ง event ทดสอบ
  2. กลับมาที่แอป สังเกต status dot ข้างชื่อ Ko-fi และบรรทัด "Last received: …"
  • 🟢 เขียว = Connected — มี Webhook URL + Verification Token ครบและรับ event ได้แล้ว
  • 🔴 แดง = ยังไม่ครบ — ตรวจว่าวาง URL ใน Ko-fi แล้ว และวาง Verification Token ในแอปแล้ว

Tips & Troubleshooting​

  • กด Send Test แล้วขึ้นว่า unverified / ถูกปฏิเสธ: Verification Token ไม่ตรง — คัดลอกใหม่จาก Ko-fi → API → Advanced แล้ววางทับใน Donari
  • โดเนทบางชนิดไม่เด้ง: Ko-fi มีหลายชนิด event — แอปเด้งเฉพาะ Tip / Donation / Subscription ส่วน Commission / Shop Order จะถูกข้าม
  • ยอดเป็นบาทไม่ตรง: Ko-fi รองรับหลายสกุลเงิน แอปแปลงเป็นบาทตามเรตปัจจุบัน
  • เปลี่ยน URL / สงสัยว่า URL หลุด: กด Regenerate ในแอป แล้วนำ URL ใหม่ไปวางทับใน Ko-fi (ของเดิมใช้ไม่ได้ทันที)

ดูเพิ่มเติม​