อินเทอร์เน็ตแบงก์กิ้ง (ประเทศไทย)
หัวข้อทั้งหมดในหน้านี้
อินเทอร์เน็ตแบงก์กิงเป็นอีกหนึ่งทางเลือกในการชำระเงินออนไลน์ที่ให้ผู้ซื้อทำรายการผ่านทางเว็บไซต์ธนาคารได้ เพียงแค่สมัครใช้บริการอินเทอร์เน็ตแบงก์กิงกับธนาคารที่ต้องการไว้
ในเบื้องต้นโอมิเซะรองรับการชำระเงินผ่านธนาคารชั้นนำ 4 แห่งดังนี้:
- ธนาคารกรุงศรีอยุธยา (Krungsri Online)
- ธนาคารกรุงเทพ (Bualuang iBanking)
- ธนาคารกรุงไทย (KTB Netbank)
- ธนาคารไทยพาณิชย์ (SCB Easy Net)
ขั้นตอนการรับชำระเงิน
การชำระเงินผ่านระบบอินเทอร์เน็ตแบงก์กิง ผู้ซื้อจะถูกส่งไปยังเว็บไซต์หรือแอปพลิเคชันของธนาคารเพื่อทำรายการ และเมื่อดำเนินการเรียบร้อยจะถูกส่งกลับมายังเว็บไซต์ของร้านค้าอีกครั้ง
ในขั้นตอนการชำระเงินบนเว็บไซต์ของร้านค้า ผู้ซื้อเลือกช่องทางการชำระเงินเป็นอินเทอร์เน็ตแบงก์กิ้ง จากนั้นจะถูกส่งไปยังหน้าเว็บไซต์ของธนาคารโดยอัตโนมัติ
จำนวนเงิน และรหัสอ้างอิงต่างๆ ที่ปกติผู้ซื้อจะต้องกรอกเองนั้น ระบบของเราจะกรอกให้โดยอัตโนมัติทั้งหมด ผู้ซื้อเพียงตรวจทานข้อมูลก่อนยืนยันรายการเท่านั้น
การสร้างรายการรับชำระเงิน
การสร้างรายการผ่านระบบอินเทอร์เน็ตแบงก์กิง คล้ายกันกับการสร้างรายการผ่านบัตรเครดิต เพียงแต่เปลี่ยนจากการส่งข้อมูลบัตรหรือ Customer (ตามคำอธิบายใน Charging Cards) เป็นการส่ง offsite ซึ่งคือชื่อของธนาคารที่ต้องการแทน
Field ทั้งหมดของ offsite มีดังนี้:
internet_banking_bay
, internet_banking_bbl
, internet_banking_ktb
และ internet_banking_scb
ด้านล่างเป็นตัวอย่างการสร้างรายการรับชำระเงินอินเทอร์เน็ตแบงก์กิงด้วย curl:
curl https://api.omise.co/charges \
-X POST \
-u skey_test_4xsjvwfnvb2g0l81sjz: \
-d "amount=100000" \
-d "currency=thb" \
-d "offsite=internet_banking_scb" \
-d "return_uri=http://example.com/orders/345678/complete"
return_uri
- เป็น URI ของหน้าเว็บไซต์ที่ผู้ซื้อจะถูกส่งกลับไป เมื่อทำการรับชำระเงินเรียบร้อย
ตัวอย่าง JSON response
{
"object": "charge",
"id": "chrg_test_56m8kzmmdazjse9jget",
"livemode": false,
"location": "/charges/chrg_test_56m8kzmmdazjse9jget",
"amount": 100000,
"currency": "thb",
"description": "test offsite charge",
"status": "pending",
"capture": true,
"authorized": false,
"reversed": false,
"paid": false,
"transaction": null,
"source_of_fund": "offsite",
"refunded": 0,
"refunds": {
"object": "list",
"from": "1970-01-01T00:00:00+00:00",
"to": "2017-01-10T09:23:11+00:00",
"offset": 0,
"limit": 20,
"total": 0,
"order": null,
"location": "/charges/chrg_test_56m8kzmmdazjse9jget/refunds",
"data": []
},
"return_uri": "http://example.com/orders/345678/complete",
"offsite": "internet_banking_scb",
"reference": "ofsp_test_56m8kzms4wzqd525jsd",
"authorize_uri": "https://pay.omise.co/offsites/ofsp_test_56m8kzms4wzqd525jsd/pay",
"failure_code": null,
"failure_message": null,
"card": null,
"customer": null,
"ip": null,
"dispute": null,
"created": "2017-01-10T09:23:11Z"
}
เพื่อดำเนินการต่อร้านค้าจะต้องส่งผู้ซื้อไปยังหน้า authorize_uri
หมายเหตุ: ในการทดสอบระบบ ให้คัดลอก URL ที่ได้รับตอบกลับจาก authorize_uri
และวางลงในเบราว์เซอร์เพื่อใช้ในการทดสอบต่อ
ร้านค้าสามารถเรียกดูสถานะของรายการได้ทุกขณะ เราได้อธิบายวิธีการเรียกข้อมูลได้จากหน้า Charges API
- หากทั้ง authorized และ paid เป็น true รายการรับชำระเงินนั้นสำเร็จ
- หากทั้ง authorized และ paid เป็น false รายการรับชำระเงินนั้นไม่สำเร็จ (สามารถตรวจสอบ failure code และ failure message ได้จาก Charge object)
- Authorized และ paid ไม่สามารถมีค่าที่ต่างกันได้
สถานะรายการ
สถานะ | รายละเอียด |
---|---|
สำเร็จ | ผู้ซื้อได้ทำการชำระเงินแล้ว (authorized = true and paid = true ) |
กำลังดำเนินการ | ผู้ซื้อยังไม่ได้ดำเนินการชำระเงิน |
หมดอายุ | ผู้ซื้อไม่ชำระเงินภายใน 24 ชั่วโมง |
ไม่สำเร็จ | รายการชำระเงินไม่สำเร็จ สามารถเรียกดูสาเหตุได้จาก failure_code และ failure_message ในข้อมูลรายการ |
รหัสข้อขัดข้อง
รหัสข้อขัดข้อง | รายละเอียด |
---|---|
insufficient_balance |
ยอดเงินในบัญชีไม่เพียงพอสำหรับทำรายการ |
payment_cancelled |
ผู้ซื้อยกเลิกการทำรายการ |
timeout |
ผู้ซื้อไม่ได้ดำเนินการใดๆ ภายใน 24 ชั่วโมงหลังจากที่ได้มีการสร้างรายการรับชำระเงิน (charge) แล้ว |
failed_processing |
รายการไม่สำเร็จด้วยเหตุผลอื่นๆ |
Webhooks
ร้านค้าสามารถรับการแจ้งเตือนเมื่อมีรายการสำเร็จ โดยใช้ Webhook API ซึ่งจะส่ง webhook ไปยัง URL ที่ ในแดชบอร์ดที่ได้ตั้งไว้ รายการจะแสดงเป็น charge.complete
หมายเหตุ
- การรับชำระเงินผ่านอินเทอร์เน็ตแบงก์กิง รองรับเฉพาะร้านค้าที่ลงทะเบียนใช้งานโอมิเซะในประเทศไทยเท่านั้น
- สำหรับร้านค้าที่อยู่ในโหมดใช้งานจริง (live account) อยู่แล้ว กรุณาส่งอีเมล์แจ้งความประสงค์ต้องการเปิดใช้งานอินเทอร์เน็ตแบงก์กิงผ่านทาง support@omise.co