หากต้องการใช้แพลตฟอร์มการชำระเงิน EBANX ใน Mavibot คุณต้องรับ Integration Key จากบัญชี EBANX ของคุณและป้อนลงในการตั้งค่าการชำระเงิน

EBANX เป็นตัวรวบรวมวิธีการชำระเงินในท้องถิ่นทั่วละตินอเมริกา การชำระเงินจะดำเนินการบนหน้าเช็คเอาต์ที่ปลอดภัยซึ่งโฮสต์โดย EBANX ซึ่งลูกค้าจะเห็นวิธีการชำระเงินที่มีในประเทศของตน (เช่น PIX และ boleto ในบราซิล OXXO และ SPEI ในเม็กซิโก PSE ในโคลอมเบีย บัตรเครดิต/เดบิต และอื่นๆ)

การรับ Integration Key

ลงนามข้อตกลงกับ EBANX และรับสิทธิ์เข้าถึง EBANX Business Portal (แดชบอร์ดผู้ค้าของคุณ)

ในระหว่างขั้นตอนการเริ่มต้นใช้งาน ให้เลือกประเทศที่คุณต้องการรับชำระเงิน ลูกค้าจะสามารถชำระเงินได้จากประเทศที่เปิดใช้งานในบัญชี EBANX ของคุณเท่านั้น

ในการตั้งค่าการรวมระบบ ให้คัดลอก Integration Key ของคุณ คุณจะต้องใช้เพื่อเชื่อมต่อ EBANX กับ Mavibot

สำหรับการทดสอบ EBANX มีบัญชี sandbox แยกต่างหากพร้อม Integration Key ของตัวเอง ดูโหมดทดสอบด้านล่าง

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

ในการตั้งค่าระบบการชำระเงิน ให้เลือก EBANX และป้อนข้อมูลต่อไปนี้:

  • Integration Key — Integration Key ของ EBANX ที่คุณคัดลอกไว้
  • Country — ประเทศการชำระเงินเริ่มต้น (รหัสประเทศสองตัวอักษรพิมพ์เล็ก: br สำหรับบราซิล, mx สำหรับเม็กซิโก, co สำหรับโคลอมเบีย, cl สำหรับชิลี, pe สำหรับเปรู, ar สำหรับอาร์เจนตินา ฯลฯ) ซึ่งกำหนดว่าลูกค้าจะเห็นวิธีการชำระเงินใดบนหน้าเช็คเอาต์ ประเทศที่เลือกต้องเปิดใช้งานในบัญชี EBANX ของคุณ
  • Test Mode — เปิดใช้งานตัวเลือกนี้เพื่อทดสอบการรวมระบบโดยใช้สภาพแวดล้อม sandbox ของ EBANX เมื่อเปิดใช้งานโหมดทดสอบ ให้ใช้ Integration Key จากบัญชี sandbox ของคุณ หากต้องการรับชำระเงินจริง ให้ปิดใช้งานโหมดทดสอบและใช้ Integration Key จริงของคุณ

การตั้งค่าเสร็จสมบูรณ์แล้ว

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

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

get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

พารามิเตอร์

  • amount — จำนวนเงินที่ชำระ จำเป็น

  • customer_email — ที่อยู่อีเมลของลูกค้า จำเป็น EBANX ไม่สามารถสร้างการชำระเงินได้หากไม่มีข้อมูลนี้ ลูกค้าจะได้รับการยืนยันการชำระเงินทางอีเมลนี้ด้วย

  • full_name — ชื่อเต็มของลูกค้า จำเป็น

  • description — คำอธิบายการชำระเงิน ไม่บังคับ

  • currency — สกุลเงินที่ชำระ คุณสามารถใช้:

    • สกุลเงินท้องถิ่นของประเทศที่ชำระเงิน (เช่น BRL, MXN, COP, CLP, PEN, ARS ฯลฯ) หรือ
    • สกุลเงินบัญชี EBANX ของคุณ (โดยทั่วไปคือ USD) ซึ่งในกรณีนี้ EBANX จะแปลงจำนวนเงินโดยใช้อัตราแลกเปลี่ยน

    ไม่บังคับ ค่าเริ่มต้นคือ USD

  • country — ประเทศที่ชำระเงิน (รหัสประเทศสองตัวอักษรพิมพ์เล็ก) ไม่บังคับ หากละเว้น จะใช้ประเทศเริ่มต้นที่ระบุในการตั้งค่าการชำระเงิน

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

หมายเหตุ: สกุลเงินที่เลือกต้องเข้ากันได้กับประเทศที่ชำระเงิน จะต้องเป็นสกุลเงินท้องถิ่นของประเทศนั้นหรือสกุลเงินบัญชี EBANX ของคุณ ตัวอย่างเช่น สำหรับ br (บราซิล) BRL และ USD ใช้ได้ ในขณะที่ MXN ใช้ไม่ได้

ปุ่มลิงก์การชำระเงิน

หากต้องการส่งปุ่มชำระเงิน ให้เลือกประเภท Payment Button และเลือก EBANX เป็นระบบการชำระเงิน

ป้อน:

  • ชื่อผลิตภัณฑ์;
  • จำนวนเงินที่ชำระ;
  • สกุลเงิน;
  • ตัวแปรที่มีชื่อเต็มและที่อยู่อีเมลของลูกค้า

คุณสามารถระบุประเทศที่ชำระเงินได้ (ไม่บังคับ)

ตัวอย่างที่ 1: การกำหนดค่าเวิร์กโฟลว์

ขั้นตอนที่ 1 สร้างบล็อก Start

บล็อก Start มักใช้เพื่อแสดงข้อความต้อนรับแรกในเวิร์กโฟลว์ พร้อมกับข้อมูลเบื้องต้นที่ผู้ใช้ต้องการ

ขั้นตอนที่ 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 product of great reliability!"
currency = "BRL"
link = get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

หากคุณต้องการรับชำระเงินในสกุลเงินอื่นที่ไม่ใช่ USD ให้ระบุสกุลเงินตามที่แสดงด้านล่าง

ตัวอย่างที่ 2: ปุ่มเรียกเก็บเงิน

ตัวอย่างนี้เกือบจะเหมือนกับ ตัวอย่างที่ 1

อย่างไรก็ตาม แทนที่จะสร้างบล็อกที่สามพร้อมฟังก์ชันสำหรับสร้างลิงก์การชำระเงิน คุณสามารถสร้างปุ่มในบล็อกที่สองได้

ในหน้าต่างที่เปิดขึ้น:

  • ป้อนข้อความปุ่ม
  • เลือกฟังก์ชัน Billing
  • เลือก EBANX เป็นผู้ให้บริการชำระเงิน

จากนั้นป้อนข้อมูลต่อไปนี้:

  • Product Name
  • Payment Amount
  • Currency (ไม่บังคับ)
  • Client Full Name (ไม่บังคับ) คุณสามารถกำหนดค่าได้เช่นเดียวกับที่คุณกำหนดค่าการป้อนอีเมลของลูกค้า
  • Customer Email — ป้อนตัวแปร #{customer_email}

จากนั้นคลิก Add

การแจ้งเตือนหลังการชำระเงิน

หลังจากที่ลูกค้าเปิดลิงก์การชำระเงินและชำระเงินเสร็จสิ้น การเรียกกลับต่อไปนี้จะถูกส่งไปยังการสนทนาเมื่อการชำระเงินสำเร็จ:

SDJ91MTKTT_success 100

โดยที่:

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

หากการชำระเงินถูกยกเลิก การเรียกกลับต่อไปนี้จะถูกส่ง:

SDJ91MTKTT_fail 100

สำหรับวิธีการชำระเงินแบบออฟไลน์ (เช่น boleto, OXXO ฯลฯ) การยืนยันการชำระเงินจะไม่เกิดขึ้นทันที EBANX จะส่งการเรียกกลับหลังจากได้รับเงินเท่านั้น ซึ่งอาจใช้เวลา 1–3 วันทำการ การเรียกกลับจะถูกส่งโดยอัตโนมัติเมื่อการชำระเงินได้รับการยืนยันแล้ว

วิธีส่งการตอบกลับไปยังการชำระเงินที่สำเร็จหรือล้มเหลว

ขั้นตอนที่ 1 สร้างบล็อก Trigger

ขั้นตอนที่ 2 ในฟิลด์เงื่อนไข ให้ป้อนข้อความแจ้งเตือน SDJ91MTKTT_success — โดยไม่มีจำนวนเงินที่ชำระ — หากคุณต้องการตอบสนองต่อทุกการชำระเงิน

ในกรณีนี้ Match Type ควรตั้งค่าเป็น By Keywords

หรือป้อนข้อความเรียกกลับทั้งหมดในฟิลด์ Trigger หากคุณต้องการตอบสนองต่อการชำระเงินที่เฉพาะเจาะจง ในกรณีนี้ Match Type ต้องตั้งค่าเป็น Exact Match

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

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

ตัวแปร ค่า
ebanx_callback_data ข้อมูลการชำระเงินที่ได้รับจากระบบการชำระเงิน
ebanx_payment_completed "True" — การชำระเงินถูกประมวลผลว่าสำเร็จ
ebanx_payment_hash ตัวระบุการชำระเงินใน EBANX (hash)