คู่มือ / ตั้งค่า

Stripe: การเชื่อมต่อและสิทธิ์ของคี⁠ย์

ใส่คี⁠ย์ Stripe แบบไหนใน POSitive และต้องเปิดสิทธิ์อะไรเพื่อรับเงิน ดูรายงานการโอน และคืนเงินเข้าบัตรของลูกค้า

POSitive ทำงานกับบัญชี Stripe ของคุณผ่านคี⁠ย์ที่คุณสร้างเอง สิทธิ์ของคี⁠ย์เป็นตัวกำหนดว่าใช้อะไรได้บ้าง: รับเงิน ดูรายงานการโอน และคืนเงินเข้าบัตรของลูกค้า

ขั้นที่ 1 สร้างคี⁠ย์ใน Stripe

  1. เปิดแดชบอร์ด Stripe → Developers → API keys
  2. กด Create restricted key แล้วตั้งชื่อ เช่น “POSitive”
  3. เปิดสิทธิ์ตามตารางด้านล่าง
  4. กด Create แล้วคัดลอกคี⁠ย์ คี⁠ย์จะขึ้นต้นด้วย rk_live_

ขั้นที่ 2 เปิดสิทธิ์

เปิดทุกแถวพร้อมกัน จะได้ไม่ต้องกลับไปที่แดชบอร์ด Stripe ทีละฟั⁠ง⁠ก์⁠ชั⁠น

ใช้ทำอะไรสิทธิ์ใน Stripeระดับ
รับเงิน: ลิงก์ชำระด้วยบัตรCheckout SessionsWrite
รับเงิน: QR ธนาคาร (PromptPay)PaymentIntentsWrite
ดูข้อมูล: ยอดคงเหลือและเงินที่กำลังดำเนินการBalanceRead
ดูข้อมูล: การโอนเข้าธนาคารPayoutsRead
ดูข้อมูล: การโอนแต่ละครั้งมาจากรายการใด และบัตรของลูกค้าBalance transaction sourcesRead
ดูข้อมูล: คำเตือนเรื่องข้อพิพาทการชำระเงินDisputesRead
ดูข้อมูล: กำหนดการโอนและคำเตือนเมื่อการโอนถูกหยุดConnect → AccountsRead
คืนเงิน เข้าบัตรของลูกค้าCharges and RefundsWrite

การคืนเงินต้องใช้ PaymentIntents และ Checkout Sessions ด้วย แต่สองแถวแรกเปิดให้แล้ว

เชื่อมต่อคี⁠ย์แล้ว แต่สิทธิ์ไม่พอ

ในแดชบอร์ด Stripe เปิดเ⁠ม⁠นู “⋯” ข้างคี⁠ย์ → Edit แล้วเพิ่มสิทธิ์ ค่าคี⁠ย์ไม่เปลี่ยน จึงไม่ต้องใส่ใน POSitive ใหม่

คี⁠ย์ที่มีสิทธิ์ Write สำหรับการคืนเงินสามารถคืนเงินได้จริง

อย่าส่งต่อในแ⁠อ⁠ปแชทหรือเก็บไว้ในโน้ต ถ้าคี⁠ย์อาจรั่วไปถึงคนอื่น ให้ลบในแดชบอร์ด Stripe แล้วสร้างใหม่ ใช้ Publishable key (pk_live_) ไม่ได้ ส่วน Secret key เต็มรูปแบบ (sk_live_) ใช้ได้ แต่มีสิทธิ์ทั้งหมด จึงควรใช้คี⁠ย์แบบจำกัดสิทธิ์

ขั้นที่ 3 ใส่คี⁠ย์ใน POSitive

  1. ในหลังร้าน เลือกร้าน แล้วเปิด ตั้งค่า → เงิน
  2. ในส่วน “ลิงก์ชำระเงิน — จากแชทและจากหน้าขาย” เปิด อนุญาตลิงก์ชำระเงิน
  3. วางคี⁠ย์ในช่อง คี⁠ย์ลับ Stripe สกุลเงินสำหรับประเทศไทยคือ thb
  4. เลือกวิธีชำระเงินที่แ⁠ค⁠ช⁠เ⁠ชี⁠ย⁠ร์จะใช้บันทึกเงิน แยกสำหรับบัตรและ QR ธนาคาร
  5. กด บันทึก คี⁠ย์ที่บันทึกแล้วจะแสดงเป็นจุด

ใส่คี⁠ย์ แยกทีละร้าน ถ้าสองร้านใช้คี⁠ย์เดียวกัน เงินจะเข้าบัญชีธนาคารเดียวกัน

สำหรับ QR ธนาคาร ให้เปิด PromptPay ในแดชบอร์ด Stripe: Settings → Payment methods

ดูเงินได้ที่ไหน

รายงานอยู่ที่ เงิน → Stripe: เงินที่กำลังโอนเข้าธนาคาร เงินที่พร้อมโอน เงินที่กำลังดำเนินการ และการโอนแต่ละครั้งมาจากรายการใด พนักงานที่มีสิทธิ์เข้าถึงการเงินเปิดดูได้

คืนเงินเข้าบัตรของลูกค้าอย่างไร

การคืนเงินต้องมีสิทธิ์ของบทบาทในการคืนเงินและยกเลิกบิลจากหลังร้าน และแ⁠อ⁠ปยืนยันตัวตน เชื่อมต่อแ⁠อ⁠ปครั้งเดียว: เ⁠ม⁠นูโปรไฟล์มุมขวาบน → แ⁠อ⁠ปยืนยันตัวตน → สแกน QR ด้วยแ⁠อ⁠ป เช่น Google Authenticator

  1. เปิด เงิน → ใบเสร็จ แล้วกดบิลที่ต้องการ
  2. ในการ์ดบิล กด คืนเงิน
  3. เลือกรายการและระบุเหตุผล
  4. ติ๊ก คืนเงินเข้าบัตรของลูกค้าผ่าน Stripe
  5. ใส่รหัส 6 หลักจากแ⁠อ⁠ปแล้วยืนยัน

เงินจะถูกส่งคืนทันทีและบันทึกการคืนเงินในบิล ปกติเงินเข้าบัตรของลูกค้าใน 5–10 วัน รหัสหนึ่งชุดยืนยันได้เพียงหนึ่งการกระทำ

คืนเข้าบัตรจาก POSitive ได้เฉพาะบิลที่จ่ายด้วย ลิงก์ Stripe จากแ⁠ค⁠ช⁠เ⁠ชี⁠ย⁠ร์:

  • ถ้าบิลจ่ายบางส่วนด้วยเงินสดหรือวิธีอื่น ให้คืนเงินแบบปกติและคืนเงินให้ลูกค้าเอง
  • อ⁠อ⁠เ⁠ด⁠อ⁠ร์ที่จ่ายบนเ⁠ว็⁠บ⁠ไ⁠ซ⁠ต์ ให้คืนเงินในแดชบอร์ด Stripe
  • บิลที่จ่ายด้วย QR ธนาคาร (PromptPay) อย่าคืนด้วยตัวเลือกนี้ Stripe จะขอเลขบัญชีจากลูกค้าทางอีเมล แต่ QR ที่แ⁠ค⁠ช⁠เ⁠ชี⁠ย⁠ร์สร้างโดยไม่มีอีเมลของลูกค้า ให้โอนเงินคืนลูกค้าเองแล้วคืนเงินแบบปกติ

ถ้ามีบางอย่างไม่ทำงาน

สิ่งที่เห็นสิ่งที่ต้องทำ
หน้า เงิน → Stripe แสดงรายชื่อสิทธิ์เพิ่มสิทธิ์เหล่านั้นให้คี⁠ย์ในแดชบอร์ด Stripe
หน้าต่างคืนเงินแจ้งว่าคี⁠ย์มีสิทธิ์ไม่พอเพิ่ม Charges and Refunds — Write
Stripe ไม่รับคี⁠ย์ตรวจว่าวางคี⁠ย์ครบและคี⁠ย์ไม่ถูกลบในแดชบอร์ด Stripe
ไม่มีปุ่ม «คืนเงิน»บิลยังเปิดอยู่ คืนเงินครบแล้ว เป็นบิลทดสอบ เป็นของร้านอื่น หรือบทบาทไม่มีสิทธิ์
ไม่มีช่องติ๊กคืนเข้าบัตรบิลไม่ได้จ่ายด้วยลิงก์ Stripe จากแ⁠ค⁠ช⁠เ⁠ชี⁠ย⁠ร์
สร้าง QR ธนาคารไม่ได้ตรวจ PaymentIntents — Write ว่าเปิด PromptPay แล้ว และสกุลเงินเป็น thb