วิธีเชื่อมต่อ

ในการเชื่อมต่อระบบชำระเงิน Coinpayments จะต้องใช้ค่า 4 ค่า: รหัสผู้ขาย (seller ID), IPN secret (สำหรับ webhooks), private api key และ public api key รวมถึงต้องตั้งค่า URL ของ webhook

ไปที่บัญชี Coinpayments -> การตั้งค่า

https://ww.coinpayments.net/index.php?cmd=acct_settings

ในแท็บแรก ให้คัดลอกรหัสผู้ขาย (seller ID)

จากนั้นไปที่แท็บการตั้งค่าของผู้ขาย และสร้างและป้อนรหัสลับ IPN - IPN secret (ใช้เพื่อยืนยันว่า webhook มาจากเรา ให้ใช้สตริงที่ซับซ้อนและเชื่อถือได้ซึ่งยากต่อการเดา)

Link IPN - URL สำหรับ webhooks ให้เพิ่มดังนี้: https://chatter.salebot.pro/coinpayments_callback/result

จากนั้นไปที่ส่วน API Keys และสร้างคู่คีย์เพื่อเข้าถึง API

บันทึก การตั้งค่าทั้งหมด คัดลอกข้อมูลและไปที่การตั้งค่าใน Mavibot เปิดส่วนระบบชำระเงิน เลือก Coinpayments

เราต้องป้อนข้อมูล

ในการสร้างลิงก์ชำระเงิน คุณต้องตั้งค่าของตัวแปรที่จำเป็น: original_currency - สกุลเงินเดิมของธุรกรรม sending_currency - สกุลเงินที่ผู้ซื้อส่ง ตัวอย่างเช่น หากสินค้าของคุณมีราคาเป็น USD แต่คุณได้รับ BTC คุณควรใช้ original_currency = USD และ sending_currency = BTC original_currency และ sending_currency อาจมีค่าเดียวกันหากไม่จำเป็นต้องแปลงสกุลเงิน

buyer_email คือที่อยู่อีเมลของผู้ซื้อ ใช้เพื่อส่งการแจ้งเตือนหากการชำระเงินน้อยเกินไปและต้องชำระเพิ่ม หรือสำหรับการคืนเงิน หากไม่ได้ระบุตัวแปรนี้ ระบบจะดึงอีเมลจากตัวแปร email โดยอัตโนมัติ หากผู้ใช้มีใน mavibot

หลังจากนั้น คุณควรตั้งค่าของตัวแปร payment_sum (เช่น 10 หรือ 0.0055 (ใช้จุด!)) ทันทีหลังจากนั้น ตัวแปร paycoinments_pay_url จะปรากฏขึ้น ตัวแปรนี้สามารถแสดงด้วยลิงก์หรือวางบนปุ่มที่มีข้อความ "ชำระเงิน" ลิงก์คือ: https://www.coinpayments.net/index.php?cmd=checkout\\&id=CPFK5QZ3FKSNWHI75CO8M4BRVkey\\&e7782d2ce24f7d03815606a5c4a882eb

นอกจากนี้ ก่อนตั้งค่าของ payment_sum คุณสามารถระบุตัวแปรเสริมต่อไปนี้เพื่อกำหนดค่าการชำระเงิน:

payment_description - ชื่อสินค้า จะปรากฏบนหน้าข้อมูลการชำระเงินและใน IPN สำหรับธุรกรรม

buyer_name - ชื่อผู้ซื้อ

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

สร้างลิงก์สำหรับการชำระเงิน 0.44444

โปรดทราบ:

  • ระบุอีเมลก่อน
  • ถัดไปคือพารามิเตอร์เสริม first_name, payment_description ฯลฯ
  • และสุดท้าย กำหนดค่าของตัวแปร payment_sum

หมายเหตุ: ก่อนอื่นเราตั้งค่าตัวแปรสำหรับการกำหนดค่า จากนั้นจึงตั้งค่า payment_sum คุณสามารถกำหนดตัวแปรก่อนหน้านี้ในเชน ไม่จำเป็นต้องอยู่ในบล็อกเดียว นี่เป็นเพียงตัวอย่าง

จากนั้น ในตำแหน่งที่เหมาะสม ให้พิมพ์ตัวแปร coinpayments_pay_url ที่มีลิงก์

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

วิธีประมวลผลผลลัพธ์

หลังจากชำระเงินสำเร็จ จะมี callbacks เข้ามาในบอท ซึ่งคุณสามารถทราบได้ว่ามีการชำระเงินสำเร็จแล้ว callbacks เหล่านี้ในระบบจะปรากฏเป็นข้อความจากผู้ใช้ เพื่อไม่ให้ผู้ใช้ส่งได้ ข้อความเหล่านี้ประกอบด้วยอักขระ 10 ตัวแรกของรหัสลับและคำว่า _success เช่น: 16831CF4b5_success

callbacks เหล่านี้ ผู้ใช้จะไม่เห็น จะแสดงเฉพาะกับโอเปอเรเตอร์เท่านั้น

ประเภทการเปรียบเทียบควรเป็น "ตรงทั้งหมด"

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

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

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

วิธีตรวจสอบสถานะการชำระเงิน

ในการตรวจสอบสถานะการชำระเงิน คุณต้องเรียก coinpayments_get_payment_status() ในฟิลด์เครื่องคิดเลข

ตัวอย่าง:

ตัวอย่างสถานะ:

กำลังรอเงินจากผู้ซื้อ...

ได้รับเงินแล้วและกำลังยืนยันการส่งถึงคุณเร็วๆ นี้...

เสร็จสมบูรณ์