ภาพรวม
รับการชำระเงินในแอปพลิเคชัน Stardeck ของคุณโดยใช้ payment gateways ยอดนิยมอย่าง Stripe และ Omise คู่มือนี้ครอบคลุมการตั้งค่าบัญชีการชำระเงิน, การกำหนดค่า API keys ใน Stardeck, และการใช้ AI agent เพื่อสร้างฟีเจอร์การชำระเงินรวมถึงการประมวลผลบัตรเครดิต, การชำระเงิน Thai QR (PromptPay), และการจัดการ webhookคู่มือนี้เน้นที่การตั้งค่าบัญชีทดสอบและการกำหนดค่า คุณสามารถใช้ AI agent ของ Stardeck เพื่อสร้างการเชื่อมต่อการชำระเงินทั้งหมด—ไม่ต้องเขียนโค้ด
ข้อกำหนดเบื้องต้น
ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:- โปรเจค Stardeck ที่ใช้งานอยู่
- ความคุ้นเคยกับ environment variables ใน Stardeck
- บัญชี payment gateway (Stripe และ/หรือ Omise)
การตั้งค่า Stripe
Stripe เป็น payment processor ยอดนิยมที่รองรับบัตรเครดิต, digital wallets, และอื่นๆการสร้างบัญชีทดสอบ Stripe
- ไปที่ stripe.com และคลิก Sign up
- ทำการลงทะเบียนให้เสร็จสมบูรณ์
- เมื่อเข้าสู่ระบบแล้ว คุณจะมีสิทธิ์เข้าถึง test mode โดยอัตโนมัติ
การรับ API Keys ของคุณ
- ใน Stripe Dashboard ไปที่ Developers > API keys
- สลับ Test mode เปิด (สวิตช์ใน sidebar ด้านซ้ายควรแสดง “Test mode”)
- คุณจะเห็น keys สองประเภท:
- Publishable key - เริ่มต้นด้วย
pk_test_...(ปลอดภัยที่จะเปิดเผยใน client-side code) - Secret key - เริ่มต้นด้วย
sk_test_...(ต้องเก็บเป็นความลับ)
- Publishable key - เริ่มต้นด้วย
การเปิดใช้งาน Payment Methods
- ไปที่ Settings > Payment methods
- ตรวจสอบว่า Cards เปิดใช้งานอยู่
- สำหรับการเชื่อมต่อ webhook จดบันทึก Webhook signing secret ของคุณจาก Developers > Webhooks
Stripe test mode ให้หมายเลขบัตรทดสอบสำหรับสถานการณ์ต่างๆ คุณสามารถหาได้ใน Stripe testing documentation
การตั้งค่า Omise
Omise เป็น payment gateway ในเอเชียตะวันออกเฉียงใต้ที่มีการรองรับที่ยอดเยี่ยมสำหรับวิธีการชำระเงินไทยรวมถึง PromptPay QR codesการสร้างบัญชีทดสอบ Omise
- ไปที่ omise.co และคลิก Sign up
- ทำการลงทะเบียนและยืนยันอีเมลให้เสร็จสมบูรณ์
- เข้าถึง dashboard ของคุณที่ dashboard.omise.co
- สลับไปยัง Test mode โดยใช้สวิตช์ใน top navigation
การรับ API Keys ของคุณ
- ใน Omise Dashboard คลิกที่ชื่อบัญชีของคุณ (บนขวา)
- ไปที่ส่วน Keys หรือ API Keys
- ใน Test mode คุณจะพบ:
- Public key - เริ่มต้นด้วย
pkey_test_...(ปลอดภัยฝั่ง client) - Secret key - เริ่มต้นด้วย
skey_test_...(server-side เท่านั้น)
- Public key - เริ่มต้นด้วย
การเปิดใช้งาน Payment Methods
- ไปที่ Settings > Payment Methods
- เปิดใช้งานต่อไปนี้สำหรับการทดสอบ:
- Credit/Debit Cards
- PromptPay (การชำระเงิน Thai QR code)
- บันทึกการตั้งค่าของคุณ
Omise ให้หมายเลขบัตรทดสอบและขั้นตอน QR payment สำหรับการทดสอบ sandbox ดู documentation ของพวกเขาสำหรับข้อมูลประจำตัวทดสอบ
การกำหนดค่า Environment Variables ใน Stardeck
เมื่อคุณมี API keys แล้ว เพิ่มพวกเขาไปยังโปรเจค Stardeck ของคุณเป็น environment variablesการเพิ่ม Stripe Keys
- เปิดโปรเจคของคุณใน Stardeck dashboard
- คลิกปุ่ม Settings (ไอคอนเฟือง)
- ไปที่แท็บ Environment Variables
- เพิ่ม variables ต่อไปนี้:
Stripe Publishable Key (Non-Secret)
- Key:
STRIPE_PUBLISHABLE_KEY - Value:
pk_test_...key ของคุณ - Secret Variable: Off (ไม่เลือก)
- Deployment Targets: เลือก Sandbox สำหรับการทดสอบ
Non-secret variables มีอยู่โดยอัตโนมัติพร้อม prefix
VITE_ สำหรับ client-side code Frontend ของคุณสามารถเข้าถึงเป็น import.meta.env.VITE_STRIPE_PUBLISHABLE_KEYStripe Secret Key (Secret)
- Key:
STRIPE_SECRET_KEY - Value:
sk_test_...key ของคุณ - Secret Variable: On (เลือก)
- Deployment Targets: เลือก Sandbox สำหรับการทดสอบ
Stripe Webhook Secret (Secret)
หากคุณวางแผนที่จะใช้ webhooks:- Key:
STRIPE_WEBHOOK_SECRET - Value:
whsec_...key ของคุณจากหน้า Stripe webhooks - Secret Variable: On (เลือก)
- Deployment Targets: เลือก Sandbox สำหรับการทดสอบ
การเพิ่ม Omise Keys
ทำตามขั้นตอนเดียวกันเพื่อเพิ่ม Omise keys:Omise Public Key (Non-Secret)
- Key:
OMISE_PUBLIC_KEY - Value:
pkey_test_...key ของคุณ - Secret Variable: Off (ไม่เลือก)
- Deployment Targets: เลือก Sandbox
Omise Secret Key (Secret)
- Key:
OMISE_SECRET_KEY - Value:
skey_test_...key ของคุณ - Secret Variable: On (เลือก)
- Deployment Targets: เลือก Sandbox
การใช้ AI Agent เพื่อสร้างฟีเจอร์การชำระเงิน
ตอนนี้ environment ของคุณได้รับการกำหนดค่าแล้ว คุณสามารถใช้ AI agent ของ Stardeck เพื่อสร้างการเชื่อมต่อการชำระเงินของคุณได้ นี่คือตัวอย่าง prompts สำหรับสถานการณ์ทั่วไป:E-commerce Checkout กับ Stripe
การชำระเงินแบบสมัครสมาชิกด้วย Webhooks
Thai Payment Gateway สำหรับธุรกิจท้องถิ่น
แดชบอร์ดการจัดการคำสั่งซื้อ
เคล็ดลับสำหรับการใช้ Prompt อย่างมีประสิทธิภาพ
- อ้างอิง environment variables ตามชื่อ - Agent รู้วิธีใช้พวกเขาอย่างถูกต้อง
- ระบุสกุลเงิน - กล่าวถึง THB สำหรับ Omise หรือ USD สำหรับ Stripe
- ขอการจัดเก็บใน database - ระบุว่าข้อมูลการชำระเงินใดควรบันทึก
- ทำให้เรียบง่าย - Agent จะจัดการ best practices สำหรับความปลอดภัยและการจัดการข้อผิดพลาด
AI agent เข้าใจ payment gateway APIs และจะใช้โค้ดที่ปลอดภัยและพร้อม production ตาม best practices
การทดสอบการเชื่อมต่อของคุณ
การทดสอบ Stripe Payments
Stripe ให้หมายเลขบัตรทดสอบสำหรับสถานการณ์ต่างๆ:- การชำระเงินสำเร็จ:
4242 4242 4242 4242 - ต้องการการยืนยันตัวตน:
4000 0025 0000 3155 - บัตรถูกปฏิเสธ:
4000 0000 0000 9995
หาบัตรทดสอบเพิ่มเติมใน Stripe’s testing documentation
การทดสอบ Omise Payments
Omise ให้บัตรทดสอบสำหรับสถานการณ์ต่างๆ:- การเรียกเก็บเงินสำเร็จ:
4242 4242 4242 4242 - การเรียกเก็บเงินล้มเหลว:
4111 1111 1111 1111 - PromptPay QR: Test mode สร้าง test QR code ที่เสร็จสมบูรณ์โดยอัตโนมัติหลังจากสองสามวินาที
10/25 และ CVV 3 หลักใดๆ สำหรับบัตรทดสอบ
การทดสอบ Webhooks ในเครื่อง
สำหรับการทดสอบ webhook ในระหว่างการพัฒนา:- ใช้เครื่องมืออย่าง ngrok หรือ localtunnel เพื่อเปิดเผย local dev server ของคุณ
- กำหนดค่า webhook URL ใน Stripe/Omise dashboard ชี้ไปยัง endpoint ที่เปิดเผยของคุณ
- ทริกเกอร์ test events จาก payment gateway dashboard
- ตรวจสอบ webhook events ใน application logs ของคุณ
การเผยแพร่ด้วย Production Keys
เมื่อคุณพร้อมที่จะรับการชำระเงินจริง:การย้ายไปยัง Production
- รับ production API keys จาก Stripe/Omise (ต้องการการยืนยันธุรกิจ)
- ใน Stardeck เพิ่ม environment variables ใหม่ ด้วย production keys
- ตั้ง Deployment Targets เป็น Production (ไม่ใช่ Sandbox)
- อัปเดต webhook URLs เพื่อชี้ไปยังโดเมน production ของคุณ
- ทดสอบอย่างละเอียด ด้วย transactions จริงขนาดเล็กก่อนเปิดตัว
Production Checklist
- การยืนยันธุรกิจเสร็จสมบูรณ์กับ payment gateway
- กำหนดค่า production API keys ใน Stardeck
- ตรวจสอบและทดสอบ webhook endpoints แล้ว
- มีการจัดการข้อผิดพลาดและการบันทึกอยู่
- กำหนดค่าอีเมลยืนยันการชำระเงิน
- จัดทำเอกสารกระบวนการคืนเงิน
- อัปเดตข้อกำหนดการให้บริการและนโยบายความเป็นส่วนตัว
- ตรวจสอบข้อกำหนด PCI compliance
แหล่งข้อมูลเพิ่มเติม
Stripe Documentation
Omise Documentation
ต้องการความช่วยเหลือในการเชื่อมต่อการชำระเงินของคุณ? ติดต่อทีมสนับสนุนของเราผ่าน dashboard ของคุณหรือติดต่อที่ [email protected]