Stripe: การเชื่อมต่อและสิทธิ์ของคีย์
ใส่คีย์ Stripe แบบไหนใน POSitive และต้องเปิดสิทธิ์อะไรเพื่อรับเงิน ดูรายงานการโอน และคืนเงินเข้าบัตรของลูกค้า
POSitive ทำงานกับบัญชี Stripe ของคุณผ่านคีย์ที่คุณสร้างเอง สิทธิ์ของคีย์เป็นตัวกำหนดว่าใช้อะไรได้บ้าง: รับเงิน ดูรายงานการโอน และคืนเงินเข้าบัตรของลูกค้า
ขั้นที่ 1 สร้างคีย์ใน Stripe
- เปิดแดชบอร์ด Stripe → Developers → API keys
- กด Create restricted key แล้วตั้งชื่อ เช่น “POSitive”
- เปิดสิทธิ์ตามตารางด้านล่าง
- กด Create แล้วคัดลอกคีย์ คีย์จะขึ้นต้นด้วย
rk_live_
ขั้นที่ 2 เปิดสิทธิ์
เปิดทุกแถวพร้อมกัน จะได้ไม่ต้องกลับไปที่แดชบอร์ด Stripe ทีละฟังก์ชัน
| ใช้ทำอะไร | สิทธิ์ใน Stripe | ระดับ |
|---|---|---|
| รับเงิน: ลิงก์ชำระด้วยบัตร | Checkout Sessions | Write |
| รับเงิน: QR ธนาคาร (PromptPay) | PaymentIntents | Write |
| ดูข้อมูล: ยอดคงเหลือและเงินที่กำลังดำเนินการ | Balance | Read |
| ดูข้อมูล: การโอนเข้าธนาคาร | Payouts | Read |
| ดูข้อมูล: การโอนแต่ละครั้งมาจากรายการใด และบัตรของลูกค้า | Balance transaction sources | Read |
| ดูข้อมูล: คำเตือนเรื่องข้อพิพาทการชำระเงิน | Disputes | Read |
| ดูข้อมูล: กำหนดการโอนและคำเตือนเมื่อการโอนถูกหยุด | Connect → Accounts | Read |
| คืนเงิน เข้าบัตรของลูกค้า | Charges and Refunds | Write |
การคืนเงินต้องใช้ PaymentIntents และ Checkout Sessions ด้วย แต่สองแถวแรกเปิดให้แล้ว
ในแดชบอร์ด Stripe เปิดเมนู “⋯” ข้างคีย์ → Edit แล้วเพิ่มสิทธิ์ ค่าคีย์ไม่เปลี่ยน จึงไม่ต้องใส่ใน POSitive ใหม่
อย่าส่งต่อในแอปแชทหรือเก็บไว้ในโน้ต ถ้าคีย์อาจรั่วไปถึงคนอื่น ให้ลบในแดชบอร์ด Stripe แล้วสร้างใหม่ ใช้ Publishable key (pk_live_) ไม่ได้ ส่วน Secret key เต็มรูปแบบ (sk_live_) ใช้ได้ แต่มีสิทธิ์ทั้งหมด จึงควรใช้คีย์แบบจำกัดสิทธิ์
ขั้นที่ 3 ใส่คีย์ใน POSitive
- ในหลังร้าน เลือกร้าน แล้วเปิด ตั้งค่า → เงิน
- ในส่วน “ลิงก์ชำระเงิน — จากแชทและจากหน้าขาย” เปิด อนุญาตลิงก์ชำระเงิน
- วางคีย์ในช่อง คีย์ลับ Stripe สกุลเงินสำหรับประเทศไทยคือ
thb - เลือกวิธีชำระเงินที่แคชเชียร์จะใช้บันทึกเงิน แยกสำหรับบัตรและ QR ธนาคาร
- กด บันทึก คีย์ที่บันทึกแล้วจะแสดงเป็นจุด
ใส่คีย์ แยกทีละร้าน ถ้าสองร้านใช้คีย์เดียวกัน เงินจะเข้าบัญชีธนาคารเดียวกัน
สำหรับ QR ธนาคาร ให้เปิด PromptPay ในแดชบอร์ด Stripe: Settings → Payment methods
ดูเงินได้ที่ไหน
รายงานอยู่ที่ เงิน → Stripe: เงินที่กำลังโอนเข้าธนาคาร เงินที่พร้อมโอน เงินที่กำลังดำเนินการ และการโอนแต่ละครั้งมาจากรายการใด พนักงานที่มีสิทธิ์เข้าถึงการเงินเปิดดูได้
คืนเงินเข้าบัตรของลูกค้าอย่างไร
การคืนเงินต้องมีสิทธิ์ของบทบาทในการคืนเงินและยกเลิกบิลจากหลังร้าน และแอปยืนยันตัวตน เชื่อมต่อแอปครั้งเดียว: เมนูโปรไฟล์มุมขวาบน → แอปยืนยันตัวตน → สแกน QR ด้วยแอป เช่น Google Authenticator
- เปิด เงิน → ใบเสร็จ แล้วกดบิลที่ต้องการ
- ในการ์ดบิล กด คืนเงิน
- เลือกรายการและระบุเหตุผล
- ติ๊ก คืนเงินเข้าบัตรของลูกค้าผ่าน Stripe
- ใส่รหัส 6 หลักจากแอปแล้วยืนยัน
เงินจะถูกส่งคืนทันทีและบันทึกการคืนเงินในบิล ปกติเงินเข้าบัตรของลูกค้าใน 5–10 วัน รหัสหนึ่งชุดยืนยันได้เพียงหนึ่งการกระทำ
คืนเข้าบัตรจาก POSitive ได้เฉพาะบิลที่จ่ายด้วย ลิงก์ Stripe จากแคชเชียร์:
- ถ้าบิลจ่ายบางส่วนด้วยเงินสดหรือวิธีอื่น ให้คืนเงินแบบปกติและคืนเงินให้ลูกค้าเอง
- ออเดอร์ที่จ่ายบนเว็บไซต์ ให้คืนเงินในแดชบอร์ด Stripe
- บิลที่จ่ายด้วย QR ธนาคาร (PromptPay) อย่าคืนด้วยตัวเลือกนี้ Stripe จะขอเลขบัญชีจากลูกค้าทางอีเมล แต่ QR ที่แคชเชียร์สร้างโดยไม่มีอีเมลของลูกค้า ให้โอนเงินคืนลูกค้าเองแล้วคืนเงินแบบปกติ
ถ้ามีบางอย่างไม่ทำงาน
| สิ่งที่เห็น | สิ่งที่ต้องทำ |
|---|---|
| หน้า เงิน → Stripe แสดงรายชื่อสิทธิ์ | เพิ่มสิทธิ์เหล่านั้นให้คีย์ในแดชบอร์ด Stripe |
| หน้าต่างคืนเงินแจ้งว่าคีย์มีสิทธิ์ไม่พอ | เพิ่ม Charges and Refunds — Write |
| Stripe ไม่รับคีย์ | ตรวจว่าวางคีย์ครบและคีย์ไม่ถูกลบในแดชบอร์ด Stripe |
| ไม่มีปุ่ม «คืนเงิน» | บิลยังเปิดอยู่ คืนเงินครบแล้ว เป็นบิลทดสอบ เป็นของร้านอื่น หรือบทบาทไม่มีสิทธิ์ |
| ไม่มีช่องติ๊กคืนเข้าบัตร | บิลไม่ได้จ่ายด้วยลิงก์ Stripe จากแคชเชียร์ |
| สร้าง QR ธนาคารไม่ได้ | ตรวจ PaymentIntents — Write ว่าเปิด PromptPay แล้ว และสกุลเงินเป็น thb |