การลงทะเบียน
หลังจากลงทะเบียนที่ https://auth.inxy.io/ ให้ไปที่ Payment gateway API ในเมนูด้านซ้าย และกรอกข้อมูลดังต่อไปนี้ - ชื่อและคำอธิบายของกระเป๋าเงินและไอคอน ลิงก์ไปยังเว็บไซต์ของคุณเป็นตัวเลือก เลือกสกุลเงินดิจิทัลทั้งหมดที่คุณต้องการรับด้วยช่องทำเครื่องหมาย แล้วคลิก Save Changes
หลังจากบันทึก หน้าต่างที่มีข้อมูลการเชื่อมต่อจะเปิดขึ้น จากนั้นสร้าง API key โดยคลิกปุ่ม Generate (1) และป้อนรหัสที่ส่งไปยังอีเมลของคุณ บันทึกตัวแปรผลลัพธ์ไว้ในที่ปลอดภัย คัดลอก Secret Key ที่สร้างขึ้นในที่เดียวกัน หากกุญแจสูญหาย สามารถสร้างใหม่ได้ (ในกรณีนี้ อย่าลืมเปลี่ยนข้อมูลในโปรเจกต์) ป้อน URL สำหรับ webhooks https://chatter.salebot.pro/inxy\_callback/result ในช่อง Postback URL (2)
การตั้งค่าการเชื่อมต่อ
จากนั้นไปที่ Mavibot — Payment systems — INXY แล้วคลิกปุ่ม Connect ป้อน API & Secret keys ที่ได้รับในฟิลด์
สกรีนช็อตการเชื่อมต่อจาก Mavibot
การสร้างลิงก์ชำระเงิน
ในการสร้างลิงก์ชำระเงิน ให้ป้อนค่าของตัวแปร payment_sum (เช่น: 1) จากนั้นตัวแปร inxy_pay_url จะปรากฏขึ้น คุณสามารถเพิ่มตัวแปรนี้บนหน้าจอเป็นลิงก์ หรือใส่ลงในปุ่ม Pay
หมายเหตุ! ระบบทำงานกับ USD! จำนวนเงินในตัวแปร payment_sum ถือเป็น USD ในระบบชำระเงิน INXY
ลิงก์มีลักษณะดังนี้: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1
นอกจากนี้ ก่อนป้อนจำนวนเงินสำหรับตัวแปร payment_sum คุณสามารถป้อน ตัวแปรเสริม ต่อไปนี้สำหรับการตั้งค่าการชำระเงิน
inxy_currency — สกุลเงินดิจิทัลที่จะใช้สำหรับการชำระเงิน คุณสามารถป้อนหนึ่งในสกุลเงินดิจิทัลที่มีอยู่ที่คุณเลือกด้วยช่องทำเครื่องหมายระหว่างการสร้าง API key หากปล่อยว่าง ผู้เล่นจะเลือกสกุลเงินดิจิทัลเองจากรายการที่เลือก ค่าที่มี: ‘BTC’,‘ETH’,‘LTC’,‘DOGE’,‘USDT’,‘USDC’,‘DAI’
inxy_description – คำอธิบายการชำระเงิน
หมายเหตุ! ก่อนอื่นคุณป้อนตัวแปรเสริมสำหรับการตั้งค่า จากนั้นจึงป้อน payment_sum
ตัวแปรสามารถป้อนก่อนหน้าในเชนได้ ไม่จำเป็นต้องอยู่ในบล็อกเดียว ในขณะที่ตัวแปร inxy_pay_url ซึ่งรวมลิงก์ ควรแสดงในตำแหน่งที่ถูกต้อง ลิงก์นี้จะเปิดแบบฟอร์มการชำระเงิน
หมายเหตุ! บรรทัด Total amount แสดงค่าเป็น USD ซึ่งเท่ากับ payment_sum บรรทัด Total crypto amount ด้านล่างแสดงค่าในสกุลเงินดิจิทัลที่เลือก ซึ่งจะแตกต่างกันไปตามอัตราแลกเปลี่ยนปัจจุบัน นี่คือจำนวนเงินที่ลูกค้าของคุณต้องจ่ายให้คุณจากกระเป๋าเงินของเขา
หมายเหตุ! ที่อยู่กระเป๋าเงินสำหรับการชำระเงินในเซสชันเดียวจะถูกสงวนไว้สำหรับลูกค้าเพียง 2 ชั่วโมงเท่านั้น แนะนำให้ลูกค้าตรวจสอบว่าเวลายังไม่หมดอายุและที่อยู่กระเป๋าเงินยังคงใช้ได้เมื่อทำการชำระเงิน หากเวลาเซสชันหมดอายุ — ต้องเริ่มกระบวนการชำระเงินทั้งหมดใหม่
Callback การชำระเงิน
หลังจากการชำระเงินสำเร็จ บอทจะได้รับ callback ที่แจ้งว่าการชำระเงินสำเร็จ คุณจะเห็น callback นี้ในระบบเป็นข้อความจากผู้ใช้ โดยที่ผู้ใช้ไม่สามารถส่งได้ ผู้ใช้เอง ไม่สามารถเห็น callback มีเพียงผู้ดำเนินการเท่านั้นที่เห็น INXY มี callback หลายประเภท:
- Success callbacks ประกอบด้วย 10 ตัวอักษรแรกของ token ตามด้วย ‘success’ เช่น: uc8zsjNN1x_success
callback ดังกล่าวจะถูกส่ง หากลูกค้าชำระเงินเต็มจำนวนและไม่มีปัญหาเกิดขึ้นระหว่างการชำระเงิน พร้อมกับ callback นี้ ตัวแปรสองตัวจะถูกเพิ่มในโปรเจกต์: inxy_payment_completed มีค่าเป็น True; และ inxy_payment_status มีค่า paid
ในระหว่างกระบวนการ ตัวแปร inxy_payment_status จะเปลี่ยนค่า หลังจากผู้ใช้เปิดแบบฟอร์ม จะเปลี่ยนเป็น waiting_payment ระหว่างการประมวลผลการชำระเงินจะเปลี่ยนเป็น waiting_confirmation และหลังจากการประมวลผลสำเร็จจะมีค่าเป็น paid หรือ partially_paid
ระหว่างการประมวลผล callback ประเภทการเปรียบเทียบควรเป็น Full match เช่น: คุณสามารถทำให้การประมวลผลการชำระเงินสำเร็จเป็นบล็อกที่มีเงื่อนไขและแสดงข้อความที่เกี่ยวข้องให้ผู้ใช้:
2. บางครั้งอัตราแลกเปลี่ยนสกุลเงินดิจิทัลเปลี่ยนแปลงหรือกระเป๋าเงินเรียกเก็บค่าธรรมเนียมเพิ่มเติมจากการทำธุรกรรม ทำให้จำนวนเงินที่คุณได้รับไม่เต็มจำนวน ในกรณีดังกล่าว ตัวแปร inxy_payment_status จะมีค่า partially_paid และระบบจะได้รับ callback ที่มีลักษณะดังนี้:
ในกรณีนี้ คุณจะต้องส่งข้อความถึงลูกค้าเพื่อขอให้ชำระส่วนที่ขาด เช่น: คุณสามารถตั้งเงื่อนไขสำหรับจุดเริ่มต้นของ callback และเมื่อได้รับ ให้ส่ง url ที่สร้างไว้ล่วงหน้าพร้อมลิงก์ชำระเงินให้ลูกค้า หรือคุณสามารถตั้งเงื่อนไขว่าบล็อกจะทำงานเมื่อค่าตัวแปร inxy_payment_status เป็น partially_paid
โปรดจำไว้ว่าลิงก์ชำระเงินใช้ได้เพียง 2 ชั่วโมงเท่านั้น! หากลูกค้าไม่ชำระเงินส่วนที่ขาดภายในเวลา จะไม่สามารถเปิดลิงก์ได้ เนื่องจาก INXY ในขั้นตอนนี้จะประมวลผลการชำระเงินบางส่วนครั้งแรก เงินจะไม่คืนให้ลูกค้า หากต้องการคืนเงิน คุณจะต้องไปที่บัญชี INXY ของคุณและดำเนินการคืนเงิน
การสร้างการสมัครสมาชิก
ระบบ INXY อนุญาตให้ผู้ใช้สร้างการสมัครสมาชิก โดยเพิ่มค่าใดๆ ลงในตัวแปร inxy_subscription_payment และจะสร้างการสมัครสมาชิกรายเดือน หากคุณต้องการกำหนดระยะเวลาอื่น ให้ใช้ตัวแปรต่อไปนี้:
inxy_subscription_interval เท่ากับ ‘day’ — จะสร้างช่วงเวลาการสมัครสมาชิกเท่ากับวัน (ค่าเริ่มต้นคือเดือน)
inxy_subscription_period — เพิ่มตัวแปรที่มีค่าตั้งแต่ 1 ถึง 30 เพื่อกำหนดระยะเวลา เช่น: ในการสร้างการชำระเงินสมัครสมาชิกทุก 15 วัน ให้ตั้งค่า inxy_subscription_interval =‘day’ และ inxy_subscription_period=15 และสำหรับการชำระเงินปีละสองครั้ง ให้ตั้งค่า inxy_subscription_period=6 (เนื่องจาก inxy_subscription_interval มีค่าเริ่มต้นเป็นเดือน)
ลิงก์จะเปิดแบบฟอร์มการชำระเงินเช่นกัน แต่จะแตกต่าง: ประการแรก ด้านข้างจะแสดงว่าการชำระเงินเป็นการสมัครสมาชิกพร้อมแสดงระยะเวลา ประการที่สอง แบบฟอร์มจะแนะนำให้ลูกค้าเพิ่มเงินฝากสำหรับการชำระเงินล่วงหน้าหลายครั้ง
ลักษณะเฉพาะของ INXY: หากลูกค้าจ่าย x2 หรือ x3 ของจำนวนเงิน Mavibot จะได้รับข้อความเกี่ยวกับจำนวนเงินเดียว ส่วนที่เหลือจะถูกฝากในยอดคงเหลือของลูกค้า และจะใช้สำหรับการชำระเงินในอนาคต เนื่องจากอัตราแลกเปลี่ยนสกุลเงินดิจิทัลผันผวน ในที่สุดจำนวนเงินนี้อาจไม่เพียงพอสำหรับการชำระเงินครั้งถัดไป ส่งผลให้การสมัครสมาชิกไม่ได้รับการชำระ ในกรณีดังกล่าว คุณจะได้รับ callback ที่ระบุว่า ‘fail’ และคุณสามารถตั้งค่าการแจ้งเตือนให้ลูกค้าได้
การสมัครสมาชิกไม่สามารถชำระบางส่วนได้ ยอดคงเหลือของลูกค้าจะถูกตรวจสอบก่อนการชำระเงิน หากมีเงินไม่เพียงพอ การชำระเงินจะไม่เกิดขึ้นเลย
หลังจากการสมัครสมาชิกสำเร็จ ตัวแปรของลูกค้าจะรวม inxy_subscribtion_id (หมายเลขอ้างอิง) และ inxy_subscription_status
การยกเลิกการสมัครสมาชิก
ในการยกเลิกการสมัครสมาชิก ให้ใช้ฟังก์ชันต่อไปนี้ inxy_remove_subscription(inxy_subscription_id) ป้อนหมายเลข id ของการสมัครสมาชิกเป็น inxy_subscribtion_id ในฟังก์ชัน และการสมัครสมาชิกจะถูกยกเลิก
ในกรณีที่สำเร็จ คุณจะได้รับ callback ‘Subscription status inxy_subscription_id - deleted’ และตัวแปร inxy_subscription_status จะเปลี่ยนเป็นค่าที่เกี่ยวข้อง
