เริ่มเชื่อมเกม

ทำตามลำดับ ตั้งแต่สมัครจนขายครั้งแรก

ขั้นที่ 1: สมัคร

เข้า dash.ez2pay.gg แล้วสมัครด้วย Google อ่านข้อตกลงจนจบแล้วกดยอมรับ ข้อตกลงระบุว่าผู้เล่นซื้อจาก EZ2Pay คุณขายของในเกมให้ EZ2Pay แล้วกดรับเงินเมื่อครบกำหนด

ขั้นที่ 2: สร้างเกมใน Dashboard

ช่อง	ตัวอย่าง	กติกา
ชื่อเกม	`My Fantasy Town`	1-100 ตัวอักษร แสดงบนหน้าจ่ายและใบเสร็จ
Slug	`my-fantasy-town`	ตัวพิมพ์เล็ก ตัวเลข ขีดกลาง 3-63 ตัว ขึ้นต้นด้วยตัวอักษรหรือตัวเลข
Webhook URL	`https://api.mygame.example/ez2pay/webhook`	HTTPS สาธารณะ พอร์ต 443 ระบบปฏิเสธที่อยู่ภายใน
หน้าช่วยเหลือ	`https://mygame.example/support`	HTTPS ผู้เล่นเห็นลิงก์นี้เมื่อมีปัญหา

เกมใหม่มีสถานะ draft ขายไม่ได้จนกว่าจะอนุมัติ

คัดลอก Webhook secret ทันที Dashboard แสดงครั้งเดียวตอนสร้างเกม ถ้าทำหาย หรือให้ AI สร้างเกมผ่าน MCP ให้เปิดหน้าเกมใน Dashboard แล้วกด สร้าง secret ใหม่ ดูเปลี่ยน Webhook secret

ขั้นที่ 3: สร้าง API key

สร้าง API key ที่หน้าเกมใน Dashboard ทำได้ตั้งแต่เกมยังเป็น draft ระบบแสดงครั้งเดียว

ข้อมูลลับ	หน้าตา	ใช้ทำอะไร
API key	`ez2_live_...`	เรียก API: สร้าง Order อ่าน Order แจ้งส่งของแล้ว
Webhook secret	ตัวอักษรสุ่ม 43 ตัว	ตรวจลายเซ็น Webhook รวมถึง ping ทดสอบ

เก็บทั้งสองตัวในตัวแปรสภาพแวดล้อมของเซิร์ฟเวอร์เท่านั้น ห้ามใส่ในโค้ด git log ฝั่ง client หรือ prompt ของ AI MCP token เป็นคนละชนิดกับ API key ใช้แทนกันไม่ได้

ขั้นที่ 4: สร้าง SKU

SKU คือของ 1 รายการที่ขาย

ช่อง	ตัวอย่าง	กติกา
รหัส	`gem-0001`	Dashboard สร้างจากคำนำหน้าที่คุณตั้งและเลขลำดับ แก้ได้เฉพาะคำนำหน้า เกมใช้รหัสนี้
ชื่อ	`เพชร 100 เม็ด`	1-200 ตัวอักษร ผู้เล่นเห็นบนหน้าจ่ายและใบเสร็จ ใบเสร็จใช้ชื่อตอนสร้าง Order
ราคา	`100`	จำนวนบาทที่ผู้เล่นจ่าย ขั้นต่ำ 59

คุณตั้งราคาที่ผู้เล่นเห็น หน้าจ่ายแสดงราคานั้นตรงๆ ไม่บวกเพิ่ม Dashboard แสดงเงินที่คุณได้รับที่ราคานั้น

ถ้าสร้างผ่าน MCP คุณตั้งรหัสเอง (ตัวอักษร ตัวเลข _ - ยาว 1-100) และส่งราคาเป็น proposed_amount_satang คือสตริงจำนวนเต็มสตางค์ เช่น "10000" คือ 100 บาท

SKU ที่สร้างใน Dashboard เป็น active ทันที SKU ที่ AI สร้างผ่าน MCP เป็น pending จนกว่าทีม EZ2Pay จะตรวจ ขายได้เฉพาะ SKU ที่เป็น active

ขั้นที่ 5: ทำ endpoint รับ Webhook

เซิร์ฟเวอร์ต้องมี endpoint ที่ URL จากขั้นที่ 2 และต้อง:

รับ POST และอ่าน raw body ก่อนแปลงเป็น JSON
ตรวจลายเซ็น
ตอบ 200 พอดีเมื่อทำงานสำเร็จทั้งหมด

กติกาอยู่ที่Webhook และการส่งมอบของ โค้ดครบชุดทั้ง Node และ Python อยู่ที่เชื่อมต่อด้วย HTTP

ขั้นที่ 6: กดทดสอบ Webhook

กดปุ่มทดสอบ Webhook ที่หน้าเกมใน Dashboard หรือให้ AI เรียก test_webhook ผ่าน MCP EZ2Pay จะส่ง ping ที่ลงนามแล้วไปที่ URL ของคุณ:

{"type":"ping"}

เซิร์ฟเวอร์ตรวจลายเซ็นแล้วตอบ 200 ping ไม่สร้าง Order หรือยอดขาย ใช้พิสูจน์แค่ว่า URL และลายเซ็นถูกต้อง

ขั้นที่ 7: ขอเปิดขาย

ทำรายการเหล่านี้ใน Dashboard ให้ครบก่อน ถ้ายังขาด คำขอจะไม่ถูกส่ง และ Dashboard แสดงรายการที่ขาด

ข้อมูลผู้รับเงิน: บุคคลหรือบริษัท ชื่อตามกฎหมาย และเลขบัตรประชาชน 13 หลักหรือเลขทะเบียนนิติบุคคล
เอกสารยืนยันตัวตน (PDF, PNG หรือ JPEG) ส่งให้ตรวจ ต้องผ่านทั้งการยืนยันตัวตนและเอกสาร
ข้อตกลงเวอร์ชันล่าสุด ถ้ามีเวอร์ชันใหม่ต้องยอมรับอีกครั้ง

จากนั้นกดขอเปิดขาย ทีม EZ2Pay จะตรวจเกม ก่อนสถานะเป็น approved การเรียก POST /v1/orders จะได้ 409 GAME_APPROVAL_REQUIRED

การขอเปิดขายต้องให้คนกดเท่านั้น AI ขอแทนผ่าน MCP ไม่ได้

ก่อนรับเงินค่าสินค้าครั้งแรก ต้องกรอกที่อยู่ภาษี สถานะ VAT และบัญชีธนาคารด้วย ชื่อบัญชีต้องตรงกับชื่อตามกฎหมาย

ขั้นที่ 8: ซื้อจริง 1 ครั้ง

ระบบไม่มีโหมดทดสอบ หลังอนุมัติแล้ว:

เข้าเกมในฐานะผู้เล่น แล้วซื้อ SKU ราคาต่ำสุด
จ่ายด้วย PromptPay QR
ตรวจว่าของเข้าครั้งเดียว และ Order ใน Dashboard เป็น DELIVERED

เช็กลิสต์

ยอมรับข้อตกลงแล้ว
สร้างเกมแล้ว และเก็บ Webhook secret บนเซิร์ฟเวอร์แล้ว
เก็บ API key บนเซิร์ฟเวอร์แล้ว
มี SKU ที่เป็น active อย่างน้อย 1 รายการ
ทดสอบ Webhook ได้ 200
ผ่านการยืนยันตัวตนและเอกสาร และเกมเป็น approved
ซื้อจริง 1 ครั้ง ของเข้าครั้งเดียว สถานะ DELIVERED

ต่อไป: Order และลิงก์จ่าย