การลงทะเบียน
หลังจากลงทะเบียนในบริการ https://auth.inxy.io/ ไปที่ Payment gateway API ในเมนูด้านซ้ายมือ และกรอกข้อมูลต่อไปนี้ - ชื่อและคำอธิบายของกระเป๋าเงินและไอคอน ลิงก์ไปยังเว็บไซต์ของคุณเป็นตัวเลือก เลือกสกุลเงินดิจิทัลทั้งหมดที่คุณต้องการรับด้วยช่องทำเครื่องหมาย และคลิก Save Changes
หลังจากบันทึก หน้าต่างพร้อมข้อมูลการเชื่อมต่อจะเปิดขึ้น จากนั้นสร้าง API key โดยกดปุ่ม Generate (1) และป้อนรหัสที่ส่งไปยังอีเมลของคุณ เก็บตัวแปรผลลัพธ์ไว้ในที่ปลอดภัย คัดลอก Secret Key ที่สร้างขึ้นในที่เดียวกัน คีย์ ในกรณีที่สูญหาย สามารถสร้างใหม่ได้ (ในกรณีนี้ อย่าลืมเปลี่ยนข้อมูลในโปรเจกต์) ป้อน URL สำหรับ webhooks https://chatter.mavibot.ai/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 ชั่วโมงเท่านั้น แนะนำให้ลูกค้าตรวจสอบให้แน่ใจว่าเวลายังไม่หมดและที่อยู่กระเป๋าเงินยังใช้ได้เมื่อทำการชำระเงิน หากเวลาของเซสชันหมด — ต้องเริ่มกระบวนการชำระเงินทั้งหมดใหม่
การเรียกกลับการชำระเงิน
หลังจากการชำระเงินสำเร็จ บอทจะได้รับการเรียกกลับที่จะบอกคุณว่าการชำระเงินสำเร็จ คุณเห็นการเรียกกลับนี้ในระบบเป็นข้อความจากผู้ใช้ เพื่อให้ผู้ใช้ไม่สามารถส่งได้ ผู้ใช้เองไม่สามารถเห็นการเรียกกลับ มีเพียงผู้ปฏิบัติการเท่านั้นที่เห็นได้ INXY มีการเรียกกลับหลายประเภท:
- การเรียกกลับที่สำเร็จประกอบด้วย 10 สัญลักษณ์แรกของโทเค็นตามด้วย 'success' เช่น: uc8zsjNN1x_success
การเรียกกลับดังกล่าวจะถูกส่ง หากลูกค้าชำระเงินเต็มจำนวนและไม่มีปัญหาเกิดขึ้นระหว่างการชำระเงิน พร้อมกับการเรียกกลับนี้ ตัวแปรสองตัวจะถูกเพิ่มลงในโปรเจกต์: inxy_payment_completed เท่ากับ True; และ inxy_payment_status ด้วยค่า paid
ในระหว่างกระบวนการ ตัวแปร inxy_payment_status จะเปลี่ยนค่า หลังจากผู้ใช้เปิดแบบฟอร์ม จะเปลี่ยนเป็น waiting_payment ระหว่างการประมวลผลการชำระเงินจะเปลี่ยนเป็น waiting_confirmation และหลังจากการประมวลผลสำเร็จจะมีค่าเป็น paid หรือ partially_paid
ในระหว่างการประมวลผลการเรียกกลับ ประเภทการเปรียบเทียบควรเป็น Full match ตัวอย่างเช่น คุณสามารถทำให้การประมวลผลการชำระเงินที่สำเร็จเป็นบล็อกที่มีเงื่อนไขและแสดงข้อความที่เกี่ยวข้องแก่ผู้ใช้:
2. บางครั้งอัตราแลกเปลี่ยนสกุลเงินดิจิทัลเปลี่ยนแปลงหรือกระเป๋าเงินเรียกเก็บค่าธรรมเนียมเพิ่มเติมจากการดำเนินการ ดังนั้นจำนวนเงินผลลัพธ์ที่คุณได้รับไม่เต็มจำนวน ในกรณีเช่นนี้ ตัวแปร inxy_payment_status จะมีค่า partially_paid และระบบจะได้รับการเรียกกลับที่มีลักษณะดังนี้:
ในกรณีนี้ คุณจะต้องส่งข้อความถึงลูกค้าพร้อมคำขอให้ชำระจำนวนเงินที่ขาด ตัวอย่างเช่น คุณสามารถตั้งเงื่อนไขสำหรับจุดเริ่มต้นของการเรียกกลับของคุณ และเมื่อได้รับการเรียกกลับ ให้ส่ง 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 จะได้รับข้อความเกี่ยวกับจำนวนเงินเดียว ส่วนที่เหลือจะถูกฝากเข้าบัญชีของลูกค้า และจะใช้สำหรับการชำระเงินที่กำลังจะมาถึง เนื่องจากอัตราแลกเปลี่ยนสกุลเงินดิจิทัลผันผวน ในที่สุดจำนวนเงินนี้อาจไม่เพียงพอสำหรับการชำระเงินครั้งใดครั้งหนึ่ง ส่งผลให้การสมัครสมาชิกไม่ได้รับการชำระ ในกรณีเช่นนี้ คุณจะได้รับการเรียกกลับที่ระบุว่า 'fail' และคุณสามารถตั้งค่าการแจ้งเตือนสำหรับลูกค้าของคุณได้
การสมัครสมาชิกไม่สามารถชำระบางส่วนได้ ยอดคงเหลือของลูกค้าจะถูกตรวจสอบก่อนการชำระเงิน หากมีเงินไม่เพียงพอ การชำระเงินจะไม่เกิดขึ้นเลย
หลังจากการสมัครสมาชิกสำเร็จ ตัวแปรของลูกค้าจะรวมถึง inxy_subscribtion_id (หมายเลขอ้างอิง) และ inxy_subscription_status
การยกเลิกการสมัครสมาชิก
เพื่อยกเลิกการสมัครสมาชิก ให้ใช้ฟังก์ชันต่อไปนี้ inxy_remove_subscription(inxy_subscription_id) ป้อนหมายเลข id ของการสมัครสมาชิกเป็น inxy_subscribtion_id ในฟังก์ชัน และการสมัครสมาชิกจะถูกยกเลิก
ในกรณีที่สำเร็จ คุณจะได้รับการเรียกกลับ 'Subscription status inxy_subscription_id - deleted' และตัวแปร inxy_subscription_status จะเปลี่ยนเป็นค่าที่เกี่ยวข้อง
