OpenCart

Extension นี้พัฒนาขึ้นเพื่อให้ร้านค้าที่ใช้งานไซต์ OpenCart สามารถเชื่อมต่อระบบรับชำระเงินของ Omise ได้โดยไม่ต้องอาศัยการเขียนโค้ดใดๆ ส่วนลูกค้า (ผู้ถือบัตร) ก็สามารถชำระเงินผ่านบัตรเครดิต/เดบิตได้อย่างสะดวกและปลอดภัยโดยไม่ต้องถูก redirect ไปยังเว็บไซต์รับชำระเงินอื่นๆ

ไปที่ source code repository github.com/omise/omise-opencart

ความต้องการของระบบและการติดตั้ง

เวอร์ชันที่รองรับ

  • OpenCart 1.5.6.4

Dependencies

  • omise-php (v2.1.2)
  • Jquery (v1.7.1 from OpenCart (v1.5.6.4)'s dependency)
  • vQmod (v2.5.1 with OpenCart integration edition)

การติดตั้ง

ขั้นตอนและวิธีการ:

ดาวน์โหลด repository และแตกไฟล์ zip ไปยังเครื่องคอมพิวเตอร์หรือเซิร์ฟเวอร์ของคุณ
ลิงก์: omise-opencart.zip หรือ omise-opencart.tar.gz omise-opencart Folder Structure

  1. ไปที่ /omise-opencart/src และคัดลอกไฟล์ทั้งหมด ไปยัง OpenCart Project

  2. เปิดไซต์ OpenCart และไปที่หน้า /admin

  3. เลือก Extensions > Payments (จากเมนูด้านบน)

Payments Menu

ไปที่ Omise Payment Gateway และกด Install
Install Omise Payment Gateway extension menu

เมื่อการติดตั้งสมบูรณ์จะพบ Omise ที่มุมขวาด้านบน บนแทบเมนู Omise Menu

Troubleshooting

กำหนดการตั้งค่าให้ omise-opencart สามารถ overwrite ไฟล์เหล่านี้:

  • your-opencart(root)/index.php
  • your-opencart(root)/admin/index.php

Extension จะสร้างไฟล์ใหม่ขึ้นและสร้างไฟล์บน your-opencart(root)/ directory เมื่อติดตั้งในครั้งแรก กรุณาตรวจสอบว่าไฟล์ทั้ง 2 นี้ ได้ตั้งค่า write permission ไว้แล้ว (โดยทั่วไปจะเป็น 755)

การ setup ระบบด้วย key

เพื่อเริ่มต้นใช้ระบบรับชำระเงินของเรา จะต้อง authenticate ด้วย key เสียก่อน ขั้นตอนมีดังนี้:

  1. ในหน้า admin ให้ไปที่ Omise > Settings
    Omise Menu

  2. กรอก keys ลงไป และหากต้องการทดสอบระบบให้เลือก Enable test mode เมื่อเปิดใช้งาน test mode ธุรกรรมที่เกิดขึ้นจะเป็นเพียงการทดสอบเท่านั้น ไม่มีการรับชำระจากลูกค้าหรือโอนเงินใดๆ เกิดขึ้นจริง
    Omise Payment Gateway Form

  3. เมนู Module config จะเป็นตัวกำหนดการเปิด (enable) หรือ ปิด (disable) ระบบรับชำระเงิน Omise บนไซต์ OpenCart
    Module Config Section

กระบวนการเช็คเอาท์

เมื่อกรอก keys ลงไปแล้ว ระบบรับชำระเงินของเราก็พร้อมใช้งานบนไซต์ OpenCart หากต้องการทดสอบระบบ อย่าลืมกรอก test keys และ enable test mode ไว้ด้วย

  1. ไปที่เว็บไซต์และเพิ่มสินค้าลงในตะกร้า

  2. เช็คเอาท์ตามขั้นตอนปกติ
    Checkout Steps

  3. ในขั้นตอนที่ 5 ให้เลือกชำระผ่าน Credit Card (Powered by Omise) และกดยืนยัน I have read and agree to terms & conditions หากยอมรับเงื่อนไขและข้อตกลง และเพื่อดำเนินการต่อ Payment Method

  4. กรอกข้อมูลบัตรลงไป สำหรับผู้ที่ทดสอบระบบใน test mode ให้เลือกใช้บัตร test card ที่เราเตรียมไว้ให้จากคู่มือการใช้งานในหน้านี้. Collect a Customer Card

  5. เมื่อกรอกข้อมูลครบถ้วน กด Confirm Order
    อ่านเพิ่มเติมเกี่ยวกับการรับข้อมูลบัตร หรือ การสร้าง Charge (Charging Cards)

  6. เมื่อจบขั้นตอนการเช็คเอาท์ เว็บไซต์จะพามาที่หน้าต่างใช้งานดังภาพ
    Checkout processed done

  7. ที่ admin dashboard รายการ order ดังกล่าวจะมีสถานะเป็น Processed Admin Dashboard
    หมายเหตุ: สถานะจะตั้งเป็น Processing ช่วงสั้นๆ ในระหว่างการ authorize

ถอนการติดตั้ง

เนื่องจากยังไม่มีวิธีตรวจสอบการใช้งานร่วมของ vQmod กับ extension อื่นๆ แบบอัตโนมัติ เราจึงแนะนำให้ถอนการติดตั้ง extension จาก source code บนเซิร์ฟเวอร์ ขั้นตอนมีดังนี้:

  • ถอนการติดตั้ง extension จากหน้า extension list
  • ลบโฟลเดอร์ vQmod จาก OpenCart directory

1. วิธีถอนการติดตั้ง extension ระบบรับชำระเงิน Omise

  1. เปิดเว็บไซต์ OpenCart และไปที่หน้า /admin

  2. ไปที่ Extensions > Payments
    Payments menu

  3. เลือก Omise Payment Gateway และกด Uninstall

เมื่อกระบวนการเสร็จสิ้น จะไม่พบเมนู Omise ที่มุมบนขวาของหน้า admin อีก

2. การลบ vQmod library

ตรวจสอบให้แน่ชัดว่า extension อื่นๆ ไม่ได้ใช้งาน library นี้ หากไม่แน่ใจสามารถเก็บไว้ได้ เนื่องจากไม่มีผลกระทบใดๆ ต่อเว็บไซต์

ใน OpenCart directory จะพบโฟลเดอร์ vqmod ให้จัดการลบทิ้งเสีย
vQmod folder

  1. ไปที่ omise-opencart/backup และทำการ restore backup files ดังภาพ
    Backup folder

คัดลอกและจัดวางลงในไซต์ OpenCart ได้เลย
- omise-opencart/backup/index.php เป็น your-opencart(root)/index.php
- omise-opencart/backup/admin/index.php เป็น your-opencart(root)/admin/index.php