การรวม PayTR ช่วยให้คุณรับชำระเงินผ่าน PayTR ซึ่งเป็นผู้ให้บริการชำระเงินของตุรกี ลูกค้าจะชำระเงินในหน้าเพย์เมนต์ที่ปลอดภัยของ PayTR ซึ่งพวกเขาสามารถใช้บัตรธนาคารของตุรกีและวิธีการชำระเงินในท้องถิ่นอื่นๆ

การรับข้อมูลประจำตัวสำหรับการรวมระบบ

ก่อนเชื่อมต่อ PayTR ให้ทำสัญญากับ PayTR และขอรับสิทธิ์เข้าถึงบัญชีผู้ค้าของคุณ

ในเมนูด้านซ้าย ให้เปิด Bilgi (ข้อมูล) และค้นหาส่วน API Entegrasyon Bilgileri คัดลอกค่าต่อไปนี้:

แดชบอร์ด PayTR ฟิลด์ Mavibot
Mağaza No Merchant ID (merchant_id)
Mağaza Anahtarı Merchant Key (merchant_key)
Mağaza Şifresi Merchant Salt (merchant_salt)

หมายเหตุ: ข้อมูลประจำตัวเหล่านี้มีให้เฉพาะ Ana Kullanıcı (ผู้ใช้หลัก) และ Teknik Sorumlu (ผู้รับผิดชอบด้านเทคนิค) เท่านั้น หากคุณไม่เห็นส่วนนี้ ให้ขอให้เจ้าของบัญชีหลักอนุญาตสิทธิ์ที่จำเป็นให้คุณ

คุณ ไม่จำเป็น ต้องกำหนดค่า URL การแจ้งเตือนการชำระเงิน (callback) ในแดชบอร์ด PayTR Mavibot จะส่ง URL callback ไปพร้อมกับคำขอสร้างลิงก์ชำระเงินทุกครั้งโดยอัตโนมัติ

การเชื่อมต่อ PayTR

เปิดการตั้งค่า Acquiring ใน Mavibot และเลือก PayTR

ป้อนข้อมูลประจำตัวต่อไปนี้:

  • Merchant ID (merchant_id) — Mağaza No ของคุณ
  • Merchant Key (merchant_key) — Mağaza Anahtarı ของคุณ
  • Merchant Salt (merchant_salt) — Mağaza Şifresi ของคุณ

บันทึกการตั้งค่าเพื่อดำเนินการรวมระบบให้เสร็จสมบูรณ์

การสร้างลิงก์ชำระเงิน

ใช้ฟังก์ชันเครื่องคิดเลข:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

พารามิเตอร์

พารามิเตอร์ จำเป็น คำอธิบาย
amount ✅ จำนวนเงินที่ชำระ
description ไม่ คำอธิบายการชำระเงิน (สินค้าหรือบริการ) แสดงบนหน้าเพย์เมนต์ของ PayTR
currency ไม่ สกุลเงินที่ชำระ: TL, USD, EUR, GBP หรือ RUB ค่าเริ่มต้น: TL
customer_email ไม่ ที่อยู่อีเมลของลูกค้า
product_name ไม่ ชื่อสินค้าที่แสดงบนหน้าเพย์เมนต์
expired ไม่ อายุของลิงก์ชำระเงินเป็นวินาที หากไม่ระบุ ลิงก์จะไม่มีวันหมดอายุ
language ไม่ ภาษาของหน้าเพย์เมนต์: tr (ตุรกี) หรือ en (อังกฤษ) ค่าเริ่มต้น: tr

ฟังก์ชันจะส่งคืน URL การชำระเงิน

หมายเหตุ

  • รหัสสกุลเงิน TRY จะถูกแปลงเป็น TL โดยอัตโนมัติ
  • หากระบุสกุลเงินที่ไม่รองรับ จะใช้ TL โดยอัตโนมัติ
  • ชื่อสินค้าต้องมี 4–200 ตัวอักษร
    • ชื่อที่สั้นกว่า 4 ตัวอักษรจะถูกเติมด้วยจุด (.)
    • ชื่อที่ยาวกว่า 200 ตัวอักษรจะถูกตัดทอนโดยอัตโนมัติ

ตัวอย่าง

ขั้นตอนที่ 1

สร้างข้อความที่ขอให้ลูกค้ากรอกที่อยู่อีเมล

ขั้นตอนที่ 2

สร้างบล็อกถัดไปใต้ข้อความและเปิด การตั้งค่าลูกศร

กำหนดค่า Connection ดังนี้:

  • ประเภทการจับคู่: Regular expression
  • เปิดใช้งานตัวเลือก User enter data
  • ป้อนชื่อตัวแปร: customer_email

บันทึกการตั้งค่า Connection

ขั้นตอนที่ 3

ป้อนพารามิเตอร์ฟังก์ชันในเครื่องคิดเลข

การสร้างปุ่มชำระเงิน

ในการส่งปุ่มชำระเงินใน Mavibot:

  1. สร้างบล็อกที่มีปุ่ม

  1. เลือกประเภท Billing
  2. เลือก PayTR เป็นผู้ให้บริการชำระเงิน
  3. ระบุ:
    • ชื่อสินค้า
    • จำนวนเงินที่ชำระ
    • สกุลเงิน
  4. สามารถระบุตัวแปรที่มีที่อยู่อีเมลของลูกค้าได้ (ไม่บังคับ)

การแจ้งเตือนการชำระเงิน (Callbacks)

หลังจากลูกค้าชำระเงินเสร็จสิ้น Mavibot จะได้รับการแจ้งเตือนและโพสต์ไปยังการสนทนา

การชำระเงินสำเร็จ

SDJ91MTKTT_success 100

โดยที่:

  • SDJ91MTKTT คือ 10 ตัวอักษรแรกของ Merchant Key (merchant_key) ของคุณ
  • 100 คือจำนวนเงินที่ชำระ

หากต้องการตอบสนองต่อการชำระเงินที่สำเร็จหรือล้มเหลว ให้คัดลอกค่า callback และสร้างบล็อก Start (หรือบล็อก Trigger)

ป้อนข้อความ callback ในทริกเกอร์

จากนั้นสร้างข้อความแจ้งให้ลูกค้าทราบว่าการชำระเงินสำเร็จหรือล้มเหลว

จากบล็อกนี้ คุณสามารถดำเนินการต่อในโฟลว์แชทบอทตามที่ต้องการ

หมายเหตุ: การกำหนดค่าทริกเกอร์ที่แสดงในตัวอย่างนี้จะตอบสนองต่อ ทุกการชำระเงินที่สำเร็จ เนื่องจากใช้เฉพาะคำนำหน้า callback โดยไม่มีจำนวนเงิน
หากคุณต้องการตอบสนองเฉพาะการซื้อสินค้าหรือจำนวนเงินที่ระบุ ให้ป้อน ข้อความ callback แบบเต็ม รวมถึงจำนวนเงิน และเปลี่ยน ประเภทการจับคู่ เป็น Exact match

การชำระเงินล้มเหลว

SDJ91MTKTT_fail 100

หมายเหตุ: ลิงก์ชำระเงินของ PayTR เป็นแบบ ใช้ครั้งเดียว หลังจากการชำระเงินสำเร็จ ลิงก์จะถูกปิดใช้งานโดยอัตโนมัติ สร้างลิงก์ชำระเงินใหม่สำหรับการชำระเงินแต่ละครั้ง

ตัวแปรของลูกค้าหลังการชำระเงินสำเร็จ

ตัวแปร คำอธิบาย
paytr_callback_data ข้อมูลการชำระเงินที่ได้รับจาก PayTR
paytr_payment_completed "True" หากการชำระเงินดำเนินการสำเร็จ
paytr_merchant_oid ตัวระบุธุรกรรมของ PayTR (merchant_oid)