วิธีการใช้การเรียกเก็บเงิน¶

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

ภาพรวม¶

IAP v4 ช่วยให้คุณ:

พัฒนาระบบการชำระเงินบน Google Play Store, Apple App Store, ONE Store และ Lebi Store ด้วย API เดียว
คำนวณ VAT ตามสกุลเงินและส่งข้อมูลเมื่อเกมขอข้อมูลรายการ
ให้รายการ Market PID ที่ลงทะเบียนในระบบข้อมูลในการขายผ่าน Hive SDK
ส่งบันทึกการชำระเงินของเกมไปยัง Analytics v2 เมื่อไคลเอนต์เกมขอการตรวจสอบใบเสร็จของเกมไปยังเซิร์ฟเวอร์ IAP v4
ดำเนินการซื้อโดยอิงจาก Market PID
รวบรวมบันทึกในกระบวนการก่อนการซื้อ (เมื่อแตะที่การซื้อ), การซื้อ (หลังการซื้อ) และหลังการซื้อ (หลังจากเรียกใช้ฟังก์ชันเสร็จสิ้น) เพื่อชี้แจงสถานะปัจจุบันของการซื้อรวมถึงกระบวนการตรวจสอบ
IAP v4 ซื้อรายการ, ตรวจสอบใบเสร็จ, ส่งบันทึก การส่งรายการจะถูกจัดการโดยเซิร์ฟเวอร์เกม
ในสภาพแวดล้อม Windows จะรองรับ การชำระเงิน PG และการชำระเงินในตลาด Steam
การตั้งค่า Hive Console ต่อไปนี้เป็นสิ่งจำเป็นสำหรับการชำระเงินในตลาด Steam:
หากคุณตั้งค่าสภาพแวดล้อม Steam เป็น sandbox การชำระเงินจะทำใน sandbox

กระบวนการซื้อด้วย IAP v4¶

สถานะของฟีเจอร์ IAP v4 ที่รองรับ¶

ระบบปฏิบัติการ	iOS	Android							Windows
ตลาด/แพลตฟอร์ม	Apple AppStore	Google PlayStore	ONE Store v4	ONE Store v7 (v5,v6)	Samsung GalaxyStore	Amazon AppStore	Huawei AppConnect	PG	Steam
การซื้อครั้งเดียว	O	O	O	O	O	O	O	O	O
การซื้อหลายครั้ง	-	O	-	-	-	-	-	O	-
คืนค่าการซื้อ	O	O	O	O	O	O	O	O	O
ค้นหาประวัติการยกเลิก/คืนเงิน	O	O	X	O	X	O	O	O	O
คืนเงินการชำระเงินของผู้ใช้	O	O	X	O	X	O	O	O	O
การสมัครสมาชิก	O	O	X	O	O	O	O	X	X
การสมัครสมาชิกที่ต่ออายุอัตโนมัติ	รายสัปดาห์, 1 เดือน, 2 เดือน, 3 เดือน, 6 เดือน, รายปี	รายสัปดาห์, 1 เดือน, 3 เดือน, 6 เดือน, รายปี	X	รายสัปดาห์, 1 เดือน, 3 เดือน, 6 เดือน, รายปี	รายสัปดาห์, 1 เดือน, 3 เดือน, 6 เดือน, รายปี	รายสัปดาห์, ทุกสองสัปดาห์, รายเดือน, ทุกสองเดือน, รายไตรมาส, ทุกครึ่งปี, รายปี	P1W, P1M, P2M, P6M, P1Y, ..., ISO 8601	X	X
Payload สนับสนุน	O	O	ไม่รองรับ	O	O	O	O	O	O

แผนภาพการไหลเพื่อซิงค์กับ IAP v4¶

Warning

Apple ไม่สนับสนุน Apple Game Center และการซื้อในแอปด้วย iOS Enterprise.

Note

เนื่องจากฟีเจอร์การสนับสนุนหน้าจอสัมผัสของ Steam เอง เมื่อสัมผัสหน้าต่างที่เปิดเผยโดย Steam (เช่น หน้าจอการชำระเงิน) บน UMPCs อาจทำให้ทำงานตรงข้ามกับเจตนาของผู้ใช้ ใน SteamDeck ฟังก์ชันการสัมผัสทำงานได้อย่างถูกต้อง

Note

เมื่อต้องการเชื่อมต่อ Mobile PG โปรดดู Mobile PG Integration Flow

Integration flow for multiple markets¶

หากแอปรองรับหลายมาร์เก็ต (เช่น App Store + Hive Store) ให้เรียก API ตาม flow ด้านล่าง

flowchart TD
    A(["marketConnect"])
    B(["getProductInfo"])
    C(["setMarketSelection"])
    D(["purchase"])
    E(["Receipt Verification (Game Server)"])
    F(["transactionFinish"])

    A -- "Once when app launches" --> B
    B -- "Once per market initially" --> C
    C -- "Designate market for purchase" --> D
    D --> E --> F

Note

getProductInfo ต้องเรียกเพียงครั้งเดียวต่อมาร์เก็ตเท่านั้น ไม่จำเป็นต้องเรียกซ้ำแม้เปลี่ยนมาร์เก็ตภายหลัง
ทุกครั้งที่ผู้ใช้เปลี่ยนวิธีชำระเงิน (มาร์เก็ต) ให้เรียก setMarketSelection ก่อน purchase หรือ restore
รายละเอียดช่วงเวลาที่ควรเรียก API ดูที่ Market Selection