ข้ามไปยังเนื้อหาหลัก

ปลั๊กอิน EC-CUBE

ยอมรับการชำระเงินบน EC-CUBE store ของคุณด้วย Omise การสนับสนุนเฉพาะสำหรับตลาดญี่ปุ่นรวมถึง Konbini, Pay-easy และบัตร JCB

ภาพรวม​

  • รองรับ EC-CUBE 4.x
  • การติดตั้ง Composer
  • วิธีการชำระเงินของญี่ปุ่น
  • การสนับสนุนบัตร JCB
  • การชำระเงิน Konbini
  • การสนับสนุน Pay-easy
  • สนับสนุนหลายภาษา (ญี่ปุ่น/อังกฤษ)

ข้อกำหนดเบื้องต้น​

ข้อกำหนด:

  • EC-CUBE 4.0.x หรือเวอร์ชันใหม่กว่า
  • PHP 7.4 หรือเวอร์ชันใหม่กว่า
  • Composer ติดตั้งแล้ว
  • บัญชี Omise Japan ที่ใช้งานอยู่
  • การเข้าถึงแอดมิน

การติดตั้ง​

ผ่าน Composer​

# นำทางไปยัง EC-CUBE root
cd /path/to/eccube

# ขอปลั๊กอิน Omise
composer require omise/omise-eccube

# ติดตั้งปลั๊กอิน
php bin/console eccube:plugin:install --code=Omise

# เปิดใช้งานปลั๊กอิน
php bin/console eccube:plugin:enable --code=Omise

# ลบแคช
php bin/console cache:clear

การติดตั้งด้วยตนเอง​

  1. ดาวน์โหลดจาก GitHub
  2. แยกไปยัง app/Plugin/Omise
  3. เรียกใช้คำสั่งการติดตั้งข้างบน

การกำหนดค่า​

การตั้งค่าปลั๊กอิน​

管理画面 → オーナーズストア → プラグイン → Omise設定

基本設定:
- เปิดใช้งาน: ใช่
- โหมดทดสอบ: ใช่ (สำหรับการทดสอบ)
- โหมดผลิตภัณฑ์: ไม่ (สำหรับการใช้งาน)

คีย์ API:
- Public Key (ทดสอบ): pkey_test_xxxxx
- Secret Key (ทดสอบ): skey_test_xxxxx

วิธีการชำระเงิน​

บัตรเครดิต (クレジットカード):

✓ Visa
✓ Mastercard
✓ American Express
✓ JCB (ออกจากญี่ปุ่น)
✓ Diners Club
✓ รองรับ 3D Secure

Konbini (コンビニ決済):

✓ Seven-Eleven
✓ FamilyMart
✓ Lawson
✓ Ministop
✓ Seicomart

วันครบกำหนดในการชำระเงิน: 3 วัน
ค่าธรรมเนียม: แตกต่างกันไปตามจำนวนเงินสั่งซื้อ

Pay-easy (ペイジー):

✓ ATM Payment
✓ Internet Banking
✓ Income Institution Number Issue
✓ Customer Number Issue

วันครบกำหนดในการชำระเงิน: 7 วัน

บริการธนาคารออนไลน์ (ネットバンキング):

ธนาคารที่สนับสนุน:
- Bangkok Bank
- Kasikorn Bank
- SCB
- ธนาคารหลักอื่น ๆ

การกำหนดค่า Webhook​

Webhook URL:
https://yourstore.com/shopping/omise_webhook

การตั้งค่า Omise Dashboard:
การตั้งค่า → Webhook → เพิ่ม Webhook
- URL: Webhook URL ด้านบน
- เหตุการณ์: charge.complete, charge.failed

การทดสอบ​

บัตรทดสอบ​

การชำระเงินสำเร็จ:
หมายเลขบัตร: 4242 4242 4242 4242
วันหมดอายุ: 12/28
รหัสความปลอดภัย: 123

การชำระเงินล้มเหลว:
หมายเลขบัตร: 4000 0000 0000 0002

ความล้มเหลวในการลงทะเบียน 3D Secure:
หมายเลขบัตร: 4111 1111 1115 0002 (Visa)

ความล้มเหลวในการตรวจสอบสิทธิ์ 3D Secure:
หมายเลขบัตร: 4111 1111 1114 0003 (Visa)

ทดสอบการชำระเงิน Konbini​

1. เลือกการชำระเงิน Konbini
2. เลือก Konbini
3. หมายเลขการชำระเงินทดสอบออกแบบ
4. ยืนยันในโหมดทดสอบ

จัดการคำสั่งซื้อ​

การจัดการสถานะคำสั่งซื้อ​

การแมปสถานะคำสั่งซื้อ:
- คำสั่งซื้อใหม่ → รอชำระเงิน
- การชำระเงินเสร็จสิ้น → การชำระเงินเสร็จสิ้น
- ล้มเหลวในการชำระเงิน → ยกเลิก
- คืนเงิน → คืนเงินแล้ว

การประมวลผลการคืนเงิน​

วิธีการคืนเงิน:
1. ผู้จัดการคำสั่งซื้อ → รายละเอียดคำสั่งซื้อ
2. คลิกปุ่มคืนเงิน
3. ป้อนจำนวนเงินคืนเงิน
4. ป้อนเหตุผลในการคืนเงิน
5. ดำเนินการ

ข้อ จำกัด ในการคืนเงิน:
- บัตรเครดิต: ภายใน 120 วัน
- Konbini: ไม่สามารถคืนเงิน
- Pay-easy: ไม่สามารถคืนเงิน

วิธีการชำระเงินของญี่ปุ่น​

การชำระเงิน Konbini​

ขั้นตอนลูกค้า:

1. เลือกการชำระเงิน Konbini ที่การชำระเงิน
2. เลือก Konbini (Seven, FamilyMart เป็นต้น)
3. ออกหมายเลขการชำระเงิน
4. ชำระเงินที่ร้านค้า Konbini
5. หลังจากตรวจสอบการชำระเงินประมวลผลคำสั่งซื้อ

ข้อกำหนดของผู้ขาย:

✓ การลงทะเบียนธุรกิจของญี่ปุ่น
✓ เปิดใช้งานการชำระเงิน Konbini
✓ การตั้งค่าวันครบกำหนดในการชำระเงิน
✓ การตั้งค่าการแจ้งเตือนทางอีเมล

การชำระเงิน Pay-easy​

การตั้งค่า:

การตั้งค่า:
✓ เปิดใช้งาน Pay-easy
✓ วันครบกำหนดในการชำระเงิน: 7 วัน
✓ รับหมายเลขสถาบันการเก็บเงิน
✓ การตั้งค่าอีเมลยืนยัน

คำแนะนำลูกค้า:

วิธีการชำระเงิน:
1. ATM หรือ Internet Banking
2. เลือก "Pay-easy"
3. ป้อนหมายเลขสถาบันการเก็บเงิน
4. ป้อนหมายเลขลูกค้า
5. ป้อนหมายเลขยืนยัน
6. ชำระเงินเสร็จสิ้น

การปรับแต่ง​

ภาษาญี่ปุ่น​

src/Eccube/Resource/locale/ja/messages.ja.yaml

omise:
  payment:
    credit_card: 'クレジットカード'
    konbini: 'コンビニ決済'
    paydasy: 'Pay-easy'
    button: 'お支払いへ進む'

แม่แบบแบบกำหนดเอง​

app/Plugin/Omise/Resource/template/default/Shopping/payment.twig

การปรับแต่ง:
- การแสดงวิธีการชำระเงิน
- การเปลี่ยนไอคอน
- การปรับปรุงเค้าโครง
- ข้อความปุ่ม

แม่แบบอีเมล​

การแก้ไขแม่แบบอีเมล:
การจัดการเนื้อหา → แม่แบบอีเมล

การปรับแต่ง:
- อีเมลยืนยันคำสั่งซื้อ
- อีเมลการชำระเงินเสร็จสิ้น
- การแจ้งเตือนหมายเลขการชำระเงิน Konbini
- ข้อมูลการชำระเงิน Pay-easy

การแก้ไขปัญหา​

ปัญหาทั่วไป​

ปลั๊กอินติดตั้งไม่ได้:

วิธีแก้ไข:
1. ตรวจสอบเวอร์ชัน Composer
2. ตรวจสอบข้อกำหนด PHP
3. ตรวจสอบสิทธิ์ไฟล์
4. ลบ var/cache
5. ลองติดตั้งใหม่

การชำระเงินไม่เสร็จสิ้น:

ตรวจสอบ:
1. คีย์ API ถูกต้อง
2. สลับโหมดทดสอบ/ผลิตภัณฑ์ตรงกัน
3. Webhook ใช้งานได้
4. ตรวจสอบไฟล์บันทึก
5. ตรวจสอบการเชื่อมต่อเครือข่าย

Konbini Payment ไม่แสดง:

ตรวจสอบ:
1. เปิดใช้งานในบัญชี Omise
2. การตั้งค่าเยน (JPY)
3. ตรวจสอบการตั้งค่าปลั๊กอิน
4. ลบแคช

โหมดการแก้จุดบกพร่อง​

เปิดใช้งานโหมดการแก้จุดบกพร่อง:
ไฟล์ .env:
APP_DEBUG=true
APP_ENV=dev

ตรวจสอบบันทึก:
var/log/dev/

ความปลอดภัย​

มาตรการความปลอดภัย​

✓ HTTPS บังคับ
✓ เปิดใช้งาน 3D Secure
✓ อัปเดตปกติ
✓ รหัสผ่านแข็งแกร่ง
✓ การรับรองความถูกต้องสองปัจจัย
✓ การจำกัดการเข้าถึง IP
✓ สำรองข้อมูลปกติ

คำถามที่พบบ่อย​

คำถาม: สนับสนุน EC-CUBE 3.x หรือไม่ คำตอบ: ไม่จำเป็นต้องใช้ EC-CUBE 4.x ขึ้นไป ใช้เวอร์ชันอื่นสำหรับ 3.x

คำถาม: ค่าธรรมเนียมการชำระเงิน Konbini คืออะไร คำตอบ: แตกต่างกันไปตามจำนวนเงินสั่งซื้อ สอบถามสนับสนุน Omise สำหรับรายละเอียด

คำถาม: บัตร JCB ใช้ได้หรือไม่ คำตอบ: ใช่รองรับบัตร JCB ที่ออกจากญี่ปุ่น

คำถาม: การคืนเงินใช้เวลานานแค่ไหน คำตอบ: บัตรเครดิตคือ 7-14 วันทำการ Konbini/Pay-easy ไม่มีการคืนเงิน

คำถาม: สนับสนุนหลายภาษาหรือไม่ คำตอบ: รองรับภาษาญี่ปุ่นและอังกฤษ

คำถาม: เหมาะสำหรับมือถือหรือไม่ คำตอบ: ใช่ใช้ได้อย่างสะดวกบนสมาร์ทโฟน

คำถาม: สนับสนุนการเรียกเก็บเงินแบบเป็นระยะหรือไม่ คำตอบ: ปลั๊กอินจำนวนมากไม่รองรับ ต้องใช้ API การสมัครสมาชิก Omise แยกต่างหาก

คำถาม: มีสภาพแวดล้อมทดสอบหรือไม่ คำตอบ: ใช่ทดสอบได้อย่างปลอดภัยในโหมดทดสอบ

ขั้นตอนถัดไป​

ทรัพยากร​

ติดต่อเรา: support@omise.co