Skip to main content

เริ่มต้นอย่างรวดเร็ว

คู่มือทีละขั้นตอนสำหรับการรวม PayerScan เข้ากับแพลตฟอร์มของคุณ

ขั้นตอนที่ 1: สร้างบัญชี​

เข้าไปที่หน้าลงทะเบียน เพื่อสร้างบัญชีผู้ค้าใหม่บน PayerScan

ขั้นตอนที่ 2: สร้างร้านค้า​

หลังจากเข้าสู่ระบบแล้ว สร้างร้านค้า (Store) ใหม่ในแดชบอร์ดผู้ค้าเพื่อเริ่มรับการชำระเงิน

  1. ในแถบด้านข้าง คลิก API Crypto เพื่อเปิดรายการร้านค้า
  2. คลิกปุ่ม + Create Store
  3. กรอกข้อมูลร้านค้าและคลิก Create

ไดอะล็อกสร้างร้านค้า

📖 ดูคำแนะนำโดยละเอียดที่ คู่มือสร้างร้านค้า

ขั้นตอนที่ 3: รับ Merchant ID และ API Key​

หลังจากสร้างร้านค้าแล้ว คุณจะเห็น Merchant ID และ API Key ในรายการร้านค้า

Merchant ID และ API Key ของคุณ

  • Merchant ID — ตัวระบุร้านค้าที่ไม่ซ้ำกัน (เช่น MID-XXXXXXXXXX) ใช้ในการเรียก API
  • API Key — ใช้สำหรับยืนยันตัวตนในการเรียก API คลิกไอคอนคัดลอกเพื่อคัดลอก
warning

เก็บ API Key ของคุณให้ปลอดภัย อย่าเปิดเผยในโค้ดฝั่งไคลเอนต์หรือ repository สาธารณะ

ขั้นตอนที่ 4: ตั้งค่าที่อยู่กระเป๋าเงิน​

ก่อนสร้างใบแจ้งหนี้ ให้เพิ่มที่อยู่กระเป๋าเงินเพื่อรับการชำระเงินด้วยสกุลเงินดิจิทัล:

  • เพิ่มที่อยู่กระเป๋าเงินสำหรับรับ TRC20/BEP20/... tokens
  • คุณสามารถเพิ่มหลายที่อยู่สำหรับเหรียญและเครือข่ายเดียวกันได้

📖 ดูคำแนะนำโดยละเอียดที่ คู่มือเพิ่มกระเป๋าเงิน

tip

หากคุณต้องการรับการชำระเงินผ่าน Binance Pay ด้วย ดูที่ การตั้งค่า Binance Pay

ขั้นตอนที่ 5: ตั้งค่า Backend ของคุณ​

ตั้งค่า Backend logic เพื่อจัดการสองส่วนหลัก: การสร้างใบแจ้งหนี้ และ การจัดการ Webhooks

5.1 — API สร้างใบแจ้งหนี้​

เรียก API สร้างใบแจ้งหนี้ เพื่อสร้างลิงก์ชำระเงิน:

curl -X POST "https://api.payerscan.com/payment/crypto" \
     -H "Content-Type: application/json" \
     -H "x-api-key: YOUR_API_KEY" \
     -d '{
        "merchant_id": "MID-XXXXXXXXXX",
        "amount": 100,
        "name": "Order #123456",
        "description": "Payment for shop order",
        "callback_url": "https://your-server.com/webhook/payment",
        "completed_url": "https://your-website.com/thank-you",
        "expired_url": "https://your-website.com/",
        "request_id": "ORDER_123456"
     }'

จากนั้นเปลี่ยนเส้นทางผู้ใช้ไปยังลิงก์ url_payment ที่สร้างขึ้นในการตอบกลับ

5.2 — ติดตามสถานะการชำระเงิน​

มีสองวิธีในการติดตามสถานะการชำระเงินของใบแจ้งหนี้:

  • Webhook (⭐ แนะนำ): PayerScan ส่ง POST request ไปยัง callback_url ของคุณโดยอัตโนมัติเมื่อใบแจ้งหนี้ถูกชำระเงินหรือหมดอายุ นี่คือวิธี push แบบเรียลไทม์ — เซิร์ฟเวอร์ของคุณได้รับการแจ้งเตือนทันทีโดยไม่ต้อง poll เพียงแค่เปิด endpoint สาธารณะและจัดการ payload ที่เข้ามา

    📖 ดูคำแนะนำโดยละเอียดที่ คู่มือ Webhook

  • Get Invoice API: หากคุณต้องการวิธี pull สามารถเรียก Get Invoice API เพื่อตรวจสอบสถานะปัจจุบันของใบแจ้งหนี้ใดก็ได้ตลอดเวลาผ่าน trans_id เหมาะสำหรับการตรวจสอบสถานะตามต้องการ การกระทบยอดคำสั่งซื้อ หรือเป็นทางเลือกสำรองเมื่อ webhook ล่าช้า

    📖 ดูคำแนะนำโดยละเอียดที่ Get Invoice

ขั้นตอนที่ 6: สร้างใบแจ้งหนี้ใบแรกของคุณ​

เมื่อ Backend พร้อมแล้ว สร้างใบแจ้งหนี้ใบแรกเพื่อทดสอบขั้นตอนการชำระเงินทั้งหมด ตรวจสอบว่า:

  • หน้าชำระเงินโหลดถูกต้องผ่านลิงก์ url_payment
  • Webhook endpoint ของคุณได้รับ callback เมื่อการชำระเงินเสร็จสิ้นหรือหมดอายุ
  • ระบบของคุณอัปเดตสถานะคำสั่งซื้อตามที่ควร