ปลั๊กอิน Magento
ยอมรับการชำระเงินบน Magento 2 store ของคุณด้วย Omise ตัวอักษรเต็มสำหรับบัตรเครดิต, การโอนธนาคาร, กระเป๋าเงินดิจิทัล, และการชำระเงินแบบผ่อนชำระพร้อมการติดตั้ง Composer ที่ง่าย
ภาพรวม
คุณสมบัติ:
- รองรับ Magento 2.3.x และ 2.4.x
- การติดตั้ง Composer
- วิธีการชำระเงิน Omise ทั้งหมด
- การกำหนดค่าแบบหลายสาขา
- จัดการคำสั่งซื้อในแอดมิน
- คืนเงินอัตโนมัติ
- รองรับ 3D Secure
- การชำระเงินที่เหมาะสำหรับมือถือ
ข้อกำหนดเบื้องต้น
ข้อกำหนด:
- Magento 2.3.x หรือ 2.4.x (หมายเหตุ: Magento 2.3 ถึงสิ้นสุดอายุการใช้งานในเดือนกันยายน พ.ศ. 2565, ขอแนะนำ 2.4.x)
- PHP 7.2 หรือเวอร์ชันใหม่กว่า (รองรับความเข้ากันได้ PHP 8.2+ ใน v3.8.0)
- Composer ติดตั้งแล้ว
- บัญชี Omise ที่ใช้งานอยู่
- การเข้าถึง SSH หรือเทอร์มินัล
- การเข้าถึงแอดมิน Magento
การติดตั้ง
ผ่าน Composer (แนะนำ)
# นำทางไปยังไดเรกทอรี Magento ราก
cd /path/to/magento
# ขอโมดูล Omise
composer require omise/omise-magento
# เปิดใช้งานโมดูล
php bin/magento module:enable Omise_Payment
# เรียกใช้การอัปเกรด setup
php bin/magento setup:upgrade
# คอมไพล์โค้ด
php bin/magento setup:di:compile
# ปรับใช้เนื้อหาแบบคงที่
php bin/magento setup:static-content:deploy
# ลบแคช
php bin/magento cache:flush
การติดตั้งด้วยตนเอง
- ดาวน์โหลดรุ่นล่าสุดจาก GitHub
- แยกไปยัง
app/code/Omise/Payment - เรียกใช้คำสั่ง setup ด้านบน
การกำหนดค่า
ขั้นตอนที่ 1: เข้าถึงการตั้งค่าการชำระเงิน
- เข้าสู่ระบบแอดมิน Magento
- นำทางไปที่ ร้านค้า → การกำหนดค่า
- ในส่วน การขาย ให้คลิก วิธีการชำระเงิน
- ค้นหาส่วน Omise Payment Gateway
ขั้นตอนที่ 2: กำหนดค่าคีย์ API
การตั้งค่าพื้นฐาน:
- เปิดใช้งาน: ใช่
- ชื่อ: Omise Payment Gateway
- สภาพแวดล้อม: Sandbox (สำหรับการทดสอบ)
การกำหนดค่า API:
- Public Key (ทดสอบ): pkey_test_xxxxx
- Secret Key (ทดสอบ): skey_test_xxxxx
- Public Key (ใช้งาน): pkey_live_xxxxx (เพิ่มในภายหลัง)
- Secret Key (ใช้งาน): skey_live_xxxxx (เพิ่มในภายหลัง)
รับคีย์ API:
- เยี่ยมชม Omise Dashboard
- ไปที่ การตั้งค่า → คีย์
- คัดลอกคีย์ทดสอบสำหรับการตั้งค่าเบื้องต้น
- คัดลอกคีย์ใช้งานเมื่อพร้อมเปิดตัว

ขั้นตอนที่ 3: เปิดใช้งานวิธีการชำระเงิน
บัตรเครดิต/เดบิต:
เปิดใช้งาน: ใช่
ชื่อ: บัตรเครดิต/เดบิต
3D Secure: เปิดใช้งาน
การดำเนินการชำระเงิน: อนุญาตและเก็บเงิน
บัตรที่ยอมรับ: Visa, Mastercard, Amex, JCB
บริการธนาคารออนไลน์:
เปิดใช้งาน: ใช่
ชื่อ: บริการธนาคารออนไลน์
ธนาคารที่สนับสนุน: ธนาคารไทยทั้งหมด
คำแนะนำ: "คุณจะถูกเป ลี่ยนเส้นทางไปยังธนาคารของคุณ"
กระเป๋าเงินดิจิทัล:
เปิดใช้งาน TrueMoney Wallet: ใช่
เปิดใช้งาน Rabbit LINE Pay: ใช่
เปิดใช้งาน ShopeePay: ใช่
การชำระเงินแบบผ่อนชำระ:
เปิดใช้งาน: ใช่
จำนวนเงินขั้นต่ำ: 3000 บาท
ระยะเวลาที่มี: 3, 6, 10 เดือน
ขั้นตอนที่ 4: กำหนดค่า Webhooks
รูปแบบ Webhook URL:
https://yourstore.com/omise/webhook/callback
การตั้งค่าใน Omise Dashboard:
- ไปที่ การตั้งค่า → Webhooks
- คลิก เพิ่ม Webhook
- ป้อน webhook URL
- เลือกเหตุการณ์:
- charge.complete
- charge.failed
- refund.create
- บันทึก webhook
ทดสอบ Webhook:
# ทดสอบจุดสิ้นสุด webhook
curl -X POST https://yourstore.com/omise/webhook/callback \
-H "Content-Type: application/json" \
-d '{"key":"charge.complete","data":{"id":"chrg_test_xxx"}}'
ขั้นตอนที่ 5: การแมปสถานะคำสั่งซื้อ
กำหนดค่าวิธีที่สถานะการชำระเงิน Omise จับคู่กับสถานะคำสั่งซื้อ Magento:
การแมปสถานะการชำระเงิน:
- รอดำเนินการ → การชำระเงินที่รอดำเนินการ
- ได้รับอนุญาต → กำลังประมวลผล
- เก็บเงิน → กำลังประมวลผล
- สำเร็จ → สมบูรณ์
- ล้มเหลว → ยกเลิก
- คืนเงิน → ปิด
การแมปสถานะแบบกำหนดเอง:
// app/code/Omise/Payment/etc/config.xml
<default>
<payment>
<omise>
<order_status>
<pending>pending_payment</pending>
<successful>processing</successful>
<failed>canceled</failed>
</order_status>
</omise>
</payment>
</default>