# Payments — รับชำระเงินออนไลน์ (Stripe)

> รับบัตรเครดิต/เดบิตและพร้อมเพย์ผ่าน Stripe Checkout ใช้กับร้านค้า รับบริจาค คอร์สออนไลน์ และโค้ดของคุณ ยืนยันด้วย webhook ที่ลงลายเซ็น

ที่มา: https://anasaki.live/docs/store/plugin-payments

ปลั๊กอิน **Payments** (`payments`) เชื่อม **Stripe Checkout** (บัตร และพร้อมเพย์สำหรับบัญชี Stripe ประเทศไทย) ต้องใช้ 2.5.0 ขึ้นไป

## ตั้งค่า

1. **Stripe secret key** (`sk_live_…` หรือ `sk_test_…` สำหรับทดลอง) — เก็บแบบเข้ารหัส
2. **Site code → ตั้งค่า → host ที่อนุญาต** เพิ่ม `api.stripe.com`
3. ที่ Stripe → Developers → Webhooks สร้าง endpoint `https:///payments/stripe/webhook` เลือก `checkout.session.completed` และ `checkout.session.async_payment_succeeded` แล้วนำ **Signing secret** (`whsec_…`) มาใส่
4. เลือก **ช่องทางชำระ**: บัตร หรือ บัตรและพร้อมเพย์

## ใช้กับปลั๊กอินอื่น

- **Shop** — มีวิธีชำระ **บัตรเครดิต/เดบิต** ลูกค้าไปจ่ายที่หน้า Stripe แล้วคำสั่งซื้อเป็น **ชำระแล้ว** เอง ถ้าเปิดหน้าจ่ายไม่สำเร็จ คำสั่งซื้อรออยู่พร้อมปุ่มจ่ายอีกครั้ง
- **Donations** — ปุ่ม **บริจาคด้วยบัตร** ยืนยันและออกใบอนุโมทนาบัตรให้อัตโนมัติ
- **Courses** — ซื้อคอร์สด้วยบัตร เปิดสิทธิ์เรียนทันที

ยอดเงินต้องตรงกับยอดของรายการ ระบบจึงยอมรับ และยืนยันแต่ละรายการครั้งเดียว หน้า **การชำระเงินออนไลน์** ในหลังบ้านแสดงทุกรายการ

## สำหรับนักพัฒนา

```ts
const { url } = plugins.call('payments', 'checkout', { ref: 'site:' + code, amount: 500, description: 'ค่าสมัคร',
  successPath: '/thanks', cancelPath: '/apply' });
site.on('payments.paid', (p) => { /* p.ref, p.amount, p.currency, p.sessionId */ });
```
