ภาพรวม

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

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

การกำหนดข้อตกลงการเรียกเก็บเงิน

ใช้ Web API ISteamMicroTxn/InitTxn เพื่อกำหนดข้อตกลงการเรียกเก็บเงินแบบเรียกเก็บซ้ำ การสร้างข้อตกลงจะใช้ลักษณะเดียวกับการขายผลิตภัณฑ์ในเกมอื่น ๆ บน Steam แต่จะต้องระบุข้อมูลเพิ่มเติมเพื่อกำหนดข้อตกลงให้ครบถ้วนสมบูรณ์ การกำหนดข้อตกลงอาจดำเนินการเป็นกิจกรรมการขายแบบเดี่ยว หรือในรถเข็นซื้อสินค้าร่วมกับไอเท็มในเกมอื่น ๆ ที่ผู้ใช้เลือกไว้เพื่อสั่งซื้อ หาก Steam ยอมรับธุรกรรม ผู้ใช้จะได้รับแจ้งให้อนุมัติข้อตกลง จากนั้น API จะคืนค่าไอดีจำเพาะของข้อตกลงการเรียกเก็บเงินประเภท 64 บิต หากมีการคืนค่าว่าเกิดข้อผิดพลาด ก็จำเป็นต้องแก้ไขปัญหาให้เสร็จสิ้นก่อน แล้วส่งคำร้องขอใหม่ เมื่ออนุมัติแล้ว คุณควรใช้ Web API ISteamMicroTxn/FinalizeTxn เพื่อดำเนินการกับข้อตกลงให้เสร็จสมบูรณ์

ระบบการเรียกเก็บเงินของเกมจะเริ่มต้นการชำระเงินแบบเรียกเก็บซ้ำ ซึ่งจะช่วยให้สามารถกำหนดจำนวนเงินที่ชำระและเวลาในการประมวลผลได้อย่างยืดหยุ่นยิ่งขึ้น เซิร์ฟเวอร์สำหรับเรียกเก็บเงินของเกมจะใช้ API ISteamMicroTxn/ProcessAgreement เพื่อเริ่มต้นการชำระเงินและระบุจำนวนเงินเพื่อการนี้ ใช้วิธีนี้ในกรณีที่คุณต้องการปรับจำนวนเงินที่ต้องชำระภายในช่วงเวลาหรือออกเครดิตให้

ผู้ใช้จะมีข้อตกลงการเรียกเก็บเงินที่มีผลใช้งานได้ 1 ข้อตกลงต่อเกมเท่านั้น คุณสามารถสร้างข้อตกลงใหม่ในการเรียกเก็บเงินจากผู้ใช้ได้ตลอดเวลา แต่ข้อตกลงการเรียกเก็บเงินก่อนหน้าทั้งหมดจะปิดใช้งานเมื่อเรียก ISteamMicroTxn/FinalizeTxn เสร็จสมบูรณ์ ข้อตกลงการเรียกเก็บเงินแต่ละรายการจะได้รับไอดีจำเพาะประเภท 64 บิต ซึ่งคุณสามารถใช้ในการอ้างอิงได้ แต่เฉพาะข้อตกลงล่าสุดเท่านั้นที่สามารถประมวลผลการชำระเงินได้

ผู้ใช้สามารถเลือกที่จะยกเลิกข้อตกลงได้ตลอดเวลาจากภายในส่วนการตั้งค่าบัญชี Steam ของตน การแจ้งเตือนหรือการยกเลิกจะดำเนินการผ่าน Web API ISteamMicroTxn/GetReport

Web API เพิ่มเติมสำหรับการชำระเงินแบบเรียกเก็บซ้ำ ได้แก่:

• ISteamMicroTxn/CancelAgreement
  
• ISteamMicroTxn/GetUserAgreementInfo
  
• ISteamMicroTxn/AdjustAgreement

การรับสถานะ

สถานะการชำระเงินสำหรับข้อตกลงการเรียกเก็บเงินสามารถเรียกได้โดยใช้ Web API สองรายการนี้:

• ISteamMicroTxn/GetUserAgreementInfo - ใช้สำหรับเรียกข้อมูลโดยละเอียดเกี่ยวกับข้อตกลงทั้งหมดสำหรับผู้ใช้ที่เกี่ยวข้องกับเกมของคุณ รวมถึงการชำระเงินที่เกิดขึ้นล่าสุด และการชำระเงินในครั้งถัดไป
  
• ISteamMicroTxn/GetUserAgreementInfo – API นี้แสดงธุรกรรมทั้งหมดที่เชื่อมโยงกับเกมของคุณ รวมถึงธุรกรรมที่สร้างจากข้อตกลงการเรียกเก็บเงิน นอกจากนี้ เนื่องจากผู้ใช้สามารถยกเลิกและต่ออายุการสมัครสมาชิกได้จากภายในบัญชี Steam ของตน เกมจะสามารถรับการแจ้งเตือนเกี่ยวกับการดำเนินการเหล่านั้นผ่าน API นี้ได้