หากต้องการใช้ PagBank เป็นผู้ให้บริการชำระเงินใน Mavibot คุณต้องได้รับโทเค็นการเข้าถึงจากบัญชี PagBank ของคุณและป้อนลงในการตั้งค่าการชำระเงิน

การรับโทเค็น

สภาพแวดล้อมการผลิต: ลงชื่อเข้าใช้บัญชี PagBank ของคุณจากคอมพิวเตอร์ ไปที่ Vendas → Integrações (การขาย → การผสานรวม) แล้วคลิก Gerar token (สร้างโทเค็น)

สภาพแวดล้อมทดสอบ (sandbox): ลงชื่อเข้าใช้ PagBank Developer Portal เปิดแท็บ Tokens แล้วคัดลอกโทเค็น sandbox ของคุณ

โทเค็นจะแสดงเพียงครั้งเดียว เก็บไว้ในที่ปลอดภัย: หากคุณทำหาย คุณจะต้องสร้างโทเค็นใหม่ และโทเค็นเก่าจะหยุดทำงาน

คุณไม่จำเป็นต้องกำหนดค่า URL การแจ้งเตือนการชำระเงินในบัญชี PagBank ของคุณ — Mavibot จะระบุให้โดยอัตโนมัติเมื่อสร้างการชำระเงินแต่ละครั้ง

การตั้งค่า

ในการตั้งค่าระบบการชำระเงิน เลือก PagBank และป้อน:

  • Token — โทเค็นการเข้าถึง API จากบัญชี PagBank ของคุณ
  • Test mode — เปิดใช้งานหากคุณป้อนโทเค็น sandbox ในโหมดทดสอบ คำขอจะถูกส่งไปยัง sandbox.api.pagseguro.com และจะไม่มีการเรียกเก็บเงินจริง

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

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

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

get_pagbank_payment_url(amount, description, product_name, customer_email, customer_phone, full_name, identity_number)

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
amount จำนวนเงินที่ต้องชำระ จำเป็นต้องระบุ ขั้นต่ำ: 1 BRL; สูงสุด: 9,999,999 BRL ป้อนจำนวนเงินเป็น 100.55 ไม่ใช่ 10055
description คำอธิบายการชำระเงิน ไม่จำเป็นต้องระบุ สูงสุด 255 ตัวอักษร ลูกค้าจะเห็นบนหน้าชำระเงิน
product_name ชื่อผลิตภัณฑ์ สูงสุด 100 ตัวอักษร ไม่จำเป็นต้องระบุ; ค่าเริ่มต้นใช้ description
customer_email ที่อยู่อีเมลของลูกค้า ไม่จำเป็นต้องระบุ; จะถูกกรอกไว้ล่วงหน้าบนหน้าชำระเงิน
customer_phone หมายเลขโทรศัพท์ของลูกค้า ไม่จำเป็นต้องระบุ; จะถูกกรอกไว้ล่วงหน้าบนหน้าชำระเงิน PagBank รับเฉพาะหมายเลขโทรศัพท์มือถือของบราซิล: รหัสประเทศ 55, รหัสพื้นที่สองหลัก, และหมายเลขเก้าหลักที่ขึ้นต้นด้วย 9 (เช่น +55 11 99999-8888)
full_name ชื่อและนามสกุลของลูกค้า ไม่จำเป็นต้องระบุ; จะถูกกรอกไว้ล่วงหน้าบนหน้าชำระเงิน
identity_number CPF (11 หลัก) หรือ CNPJ (14 หลัก) ของลูกค้า ไม่จำเป็นต้องระบุ; จะถูกกรอกไว้ล่วงหน้าบนหน้าชำระเงิน

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

PagBank รับรายละเอียดลูกค้าเฉพาะเมื่อเป็นชุดที่สมบูรณ์เท่านั้น: ต้องระบุชื่อ อีเมล หมายเลขโทรศัพท์ และ CPF/CNPJ ทั้งหมด หากฟิลด์ใดฟิลด์หนึ่งในสี่ฟิลด์นี้หายไป หรือหมายเลขโทรศัพท์ไม่ใช่หมายเลขโทรศัพท์มือถือของบราซิลที่ถูกต้อง Mavibot จะไม่ส่งรายละเอียดลูกค้าใดๆ ไปยัง PagBank ลูกค้าจะกรอกข้อมูลบนหน้าชำระเงินเอง ซึ่งไม่ส่งผลต่อการชำระเงิน

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

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

การเรียกกลับหลังการชำระเงิน

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

A1B2C3D4E5_success 100.55

ในที่นี้ A1B2C3D4E5 คือ 10 ตัวอักษรแรกของโทเค็นของคุณ และ 100.55 คือจำนวนเงินที่ชำระ

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

A1B2C3D4E5_fail 100.55

การเรียกกลับความล้มเหลวจะถูกส่งเมื่อไม่สามารถใช้ลิงก์ชำระเงินได้อีกต่อไป: ธนาคารปฏิเสธหรือยกเลิกการชำระเงินอย่างถาวร หรือลิงก์ชำระเงินหมดอายุแล้ว จะไม่มีการส่งการเรียกกลับในขณะที่การชำระเงินอยู่ระหว่างการตรวจสอบ รอการชำระเงินผ่าน boleto หรือได้รับอนุมัติแต่ยังคงระงับอยู่บนบัตร เนื่องจากลิงก์ชำระเงินยังคงใช้งานได้ ลิงก์ชำระเงินที่หมดอายุจะไม่มีการชำระเงินที่เกี่ยวข้อง ดังนั้นการเรียกกลับจะไม่รวมจำนวนเงิน

หากต้องการจัดการกับการชำระเงินที่สำเร็จหรือล้มเหลว ให้ทำตามขั้นตอนเหล่านี้:

  1. สร้างบล็อกด้วยทริกเกอร์ (บล็อก Trigger สีเทาหรือบล็อก Start สีเขียว — ใช้บล็อกสีเขียวหากคุณต้องการสร้างฟันเนลต่อหลังการชำระเงิน)
  2. ในฟิลด์ Trigger ให้ป้อนการเรียกกลับโดยไม่มีจำนวนเงินที่ชำระ:
A1B2C3D4E5_success

ใช้ตัวเลือกนี้หากคุณต้องการให้บล็อกตอบสนองต่อทุกการชำระเงินที่สำเร็จ

ตั้งค่าประเภทการจับคู่เป็น Keyword Match

หรือป้อนการเรียกกลับแบบเต็ม:

A1B2C3D4E5_success 100.55

ใช้ตัวเลือกนี้หากคุณต้องการให้บล็อกตอบสนองเฉพาะการชำระเงินสำหรับจำนวนเงินที่ระบุเท่านั้น

ตั้งค่าประเภทการจับคู่เป็น Exact Match

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

ตัวแปร ค่า
pagbank_callback_data ข้อมูลการชำระเงินที่ได้รับจากระบบการชำระเงิน
pagbank_payment_completed "True" — การชำระเงินดำเนินการสำเร็จ
pagbank_order_id รหัสคำสั่งซื้อของ PagBank (ORDE_…)
pagbank_charge_id รหัสการเรียกเก็บเงินของ PagBank (CHAR_…)
pagbank_payment_method วิธีการชำระเงิน: CREDIT_CARD, DEBIT_CARD, PIX, หรือ BOLETO