หากต้องการใช้ระบบชำระเงิน Garanti BBVA (Sanal POS) ใน Mavibot คุณต้องขอข้อมูลประจำตัวของเครื่อง POS เสมือน จากธนาคารและป้อนข้อมูลเหล่านั้นในการตั้งค่าการรวมระบบ การชำระเงินจะดำเนินการบนหน้าที่ปลอดภัยของธนาคารด้วยการยืนยัน 3D Secure
การขอข้อมูลประจำตัว
ทำสัญญากับ Garanti BBVA สำหรับบริการ Sanal POS (POS เสมือน) เมื่อเปิดใช้งานบริการ ให้ขอให้ธนาคารเปิดใช้งาน Ortak Ödeme (หน้าการชำระเงินร่วม) สำหรับเครื่องของคุณ หากไม่มีฟีเจอร์นี้ การชำระเงินผ่านหน้าการชำระเงินของธนาคารจะไม่ทำงาน
ธนาคารจะให้ข้อมูลต่อไปนี้แก่คุณ:
- Merchant ID (Üye İşyeri No) — รหัสผู้ค้าของคุณ;
- Terminal ID — รหัสเครื่องของคุณ;
- Provision User ID — ชื่อผู้ใช้ Provision (โดยปกติคือ PROVAUT หรือ PROVOOS);
- Provision Password — รหัสผ่านของผู้ใช้ Provision
Store Key (คีย์ 3D Secure) ถูกสร้างขึ้นโดยคุณในแผงการจัดการ Sanal POS (Yönetim → 3D Secure) อย่าลืมบันทึกไว้ เนื่องจากจำเป็นสำหรับการรวมระบบด้วย
วิธีเชื่อมต่อ Garanti BBVA กับ Mavibot?
ในส่วน Acquiring ของ Mavibot ให้เลือก Garanti BBVA และป้อนรายละเอียดต่อไปนี้:
- Merchant ID — รหัสผู้ค้าของคุณ
- Terminal ID — รหัสเครื่องของคุณ
- Provision User ID — ชื่อผู้ใช้ Provision หากปล่อยว่างไว้ จะใช้ PROVAUT
- Provision Password — รหัสผ่านของผู้ใช้ Provision
- Store Key — คีย์ 3D Secure ของคุณ
- Store Name — ชื่อที่แสดงต่อลูกค้าบนหน้าการชำระเงินของธนาคาร หากปล่อยว่างไว้ จะแสดง "Online store"
- Test Mode — เปิดใช้งานตัวเลือกนี้เพื่อทดสอบการรวมระบบโดยใช้ข้อมูลทดสอบของธนาคาร สำหรับการประมวลผลการชำระเงินจริง ต้องปิดตัวเลือกนี้
การรวมระบบเสร็จสมบูรณ์แล้ว
การสร้างลิงก์ชำระเงิน
ฟังก์ชัน Calculator:
get_garanti_payment_url(amount, description, currency, customer_email, language)
พารามิเตอร์:
| พารามิเตอร์ | คำอธิบาย | จำเป็น | ค่าเริ่มต้น / ค่าที่อนุญาต |
|---|---|---|---|
amount |
จำนวนเงินที่ชำระ | ✅ | — |
description |
คำอธิบายการชำระเงิน | ไม่ | — |
currency |
สกุลเงินที่ชำระ | ไม่ |
TRY (ค่าเริ่มต้น) ค่าที่รองรับ: TRY, USD, EUR, GBP, JPY
|
customer_email |
ที่อยู่อีเมลของลูกค้า | ไม่ | — |
language |
ภาษาของหน้าการชำระเงิน | ไม่ |
tr (ค่าเริ่มต้น) ค่าที่รองรับ: tr, en
|
ฟังก์ชันจะส่งคืน URL การชำระเงิน
ลิงก์ชำระเงินในปุ่ม
หากต้องการส่งปุ่มที่มีลิงก์ชำระเงิน ให้เลือกประเภทปุ่ม Payment และเลือก Garanti BBVA เป็นผู้ให้บริการชำระเงิน จากนั้นป้อนชื่อผลิตภัณฑ์ จำนวนเงินที่ชำระ และหากจำเป็น ให้ป้อนสกุลเงินที่ชำระ
ตัวอย่างที่ 1: การกำหนดค่า Workflow
ขั้นตอนที่ 1 สร้างบล็อก Start
บล็อก Start โดยทั่วไปใช้เพื่อแสดงข้อความต้อนรับแรกใน workflow พร้อมกับข้อมูลแนะนำที่ผู้ใช้ต้องการ
ขั้นตอนที่ 2 สร้างบล็อกตามที่แสดงด้านล่าง
ขั้นตอนที่ 3 ไปที่การตั้งค่า Connection
คุณจะต้องใช้นิพจน์ทั่วไปต่อไปนี้เพื่อตรวจสอบว่าลูกค้าป้อนที่อยู่อีเมลที่ถูกต้อง:
^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$
นอกจากนี้ ให้เปิดใช้งานตัวเลือก User enters data และป้อน customer_email
ขั้นตอนที่ 4 ป้อนข้อความในบล็อกที่สอง
ขั้นตอนที่ 5 สร้างบล็อกที่สามและเปิดการตั้งค่า Connection ระหว่างบล็อกที่สองและสาม
เปิดใช้งานตัวจับเวลาเพื่อดำเนินการไปยังบล็อกถัดไปโดยอัตโนมัติ
ขั้นตอนที่ 6 ในบล็อกที่สาม ให้ป้อนฟังก์ชันใน Calculator
ตัวอย่างสำหรับคัดลอก:
amount = 1000
description = "Product1 is a product of great reliability!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)
หากคุณต้องการรับชำระเงินในสกุลเงินอื่นที่ไม่ใช่ ลีราตุรกี (TRY) ให้ระบุสกุลเงินตามที่แสดงด้านล่าง
ตัวอย่างสำหรับคัดลอก:
amount = 1000
description = "Product1 is a product of great reliability!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)
ตัวอย่างที่ 2 ปุ่ม Billing
ตัวอย่างนี้เกือบจะเหมือนกับ ตัวอย่างที่ 1
อย่างไรก็ตาม แทนที่จะสร้างบล็อกที่สามด้วยฟังก์ชันสำหรับสร้างลิงก์ชำระเงิน คุณสามารถสร้างปุ่มในบล็อกที่สองได้
ในหน้าต่างที่เปิดขึ้น:
- ป้อนข้อความของปุ่ม
- เลือกฟังก์ชัน Billing
- เลือก Garanti BBVA เป็นผู้ให้บริการชำระเงิน
จากนั้นป้อนข้อมูลต่อไปนี้:
- Product Name
- Payment Amount
- Currency (ไม่บังคับ)
- Client Full Name (ไม่บังคับ) คุณสามารถกำหนดค่านี้ได้ในลักษณะเดียวกับการป้อนอีเมลของลูกค้า
-
Customer Email — ป้อนตัวแปร
#{customer_email}
จากนั้นคลิก Add
การแจ้งเตือนหลังการชำระเงิน
หลังจากที่ลูกค้าติดตามลิงก์ชำระเงินและชำระเงินเสร็จสิ้น การแจ้งเตือน (callback) จะถูกส่งไปยังการสนทนา
สำหรับการชำระเงินที่สำเร็จ:
SDJ91MTKTT_success 100
โดยที่:
-
SDJ91MTKTTคือ 10 ตัวอักษรแรกของ Store Key ของคุณ -
100คือจำนวนเงินที่ชำระ
หากการชำระเงินล้มเหลว การแจ้งเตือนต่อไปนี้จะถูกส่ง:
SDJ91MTKTT_fail 100
วิธีส่งการตอบกลับสำหรับการชำระเงินที่สำเร็จหรือล้มเหลว
ขั้นตอนที่ 1 สร้างบล็อก Trigger
ขั้นตอนที่ 2 ในฟิลด์เงื่อนไข ให้ป้อนข้อความแจ้งเตือน SDJ91MTKTT_success — โดยไม่มีจำนวนเงินที่ชำระ — หากคุณต้องการตอบสนองต่อทุกการชำระเงิน
ในกรณีนี้ Match Type ควรตั้งค่าเป็น By Keywords
หรือป้อนข้อความ callback ทั้งหมดในฟิลด์ Trigger หากคุณต้องการตอบสนองต่อการชำระเงินที่เฉพาะเจาะจง ในกรณีนี้ Match Type ต้องตั้งค่าเป็น Exact Match
หากคุณต้องการดำเนินการ workflow ต่อหลังจากการชำระเงินสำเร็จ คุณสามารถสร้างบล็อก Start แทนบล็อก Trigger และสร้างโฟลว์บอทของคุณต่อจากนั้น
ตัวแปรของลูกค้าหลังการชำระเงินสำเร็จ
| ตัวแปร | คำอธิบาย |
|---|---|
garanti_callback_data |
ข้อมูลการชำระเงินที่ได้รับจากระบบชำระเงิน |
garanti_payment_completed |
"True" หากการชำระเงินได้รับการประมวลผลสำเร็จ |
garanti_auth_code |
รหัสการอนุมัติธุรกรรมของธนาคาร |