IAP v4 ตรวจสอบใบเสร็จการสมัครสมาชิก

การตรวจสอบใบเสร็จการสมัครสมาชิกจะตอบกลับด้วยผลการตรวจสอบใบเสร็จหลังจากที่ซื้อผลิตภัณฑ์การสมัครสมาชิกและกุญแจระบุตัวตนที่สามารถระบุใบเสร็จตามตลาดได้

เนื่องจากกระบวนการสมัครสมาชิกแตกต่างกันเล็กน้อยตามตลาด จึงไม่สามารถจัดการกับทุกตลาดในลักษณะเดียวกันได้ และการตอบสนองต้องจัดการแตกต่างกันตามกุญแจการระบุใบเสร็จ: hiveiap_apple_info (Apple), hiveiap_google_info (Google), hiveiap_amazon_info (Amazon), hiveiap_huawei_info (Huawei), และ hiveiap_onestore_info (One Store).

  • การซื้อสมาชิกและการกู้คืนการซื้อ

  • การตรวจสอบการต่ออายุใบเสร็จการสมัครสมาชิก

Warning

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

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

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

Warning

ใบเสร็จสามารถต่ออายุโดยอัตโนมัติเมื่อวันหมดอายุใกล้เข้ามา แม้ว่าจะไม่ได้รับการตรวจสอบเป็นระยะๆ ก็ตาม ดังนั้นจึงจำเป็นต้องสะท้อนข้อมูลที่อัปเดตหลังจากตรวจสอบใบเสร็จเป็นระยะๆ ตามที่ระบุไว้ด้านล่าง

  • การตรวจสอบใบเสร็จสำหรับการสมัครสมาชิกเชิงพาณิชย์: ขอการตรวจสอบใบเสร็จหนึ่งวันก่อนถึงหนึ่งวันหลังจากวันหมดอายุของการสมัครสมาชิก และสะท้อนผลการตรวจสอบหรือมอบสิทธิ์เนื้อหา อย่างไรก็ตาม สำหรับการสมัครสมาชิก Amazon ใบเสร็จจะถูกประมวลผลโดยอัตโนมัติสำหรับการชำระเงินหลังจากหมดอายุ และสำหรับการชำระเงินทดสอบ ข้อมูลการต่ออายุจะถูกส่งภายใน 1 นาทีถึง 1 ชั่วโมงหลังจากหมดอายุ
  • การตรวจสอบใบเสร็จสำหรับการสมัครสมาชิกทดสอบ: ขอการตรวจสอบใบเสร็จหนึ่งนาทีก่อนถึงหนึ่งนาทีหลังจากวันหมดอายุของการสมัครสมาชิก และสะท้อนผลการตรวจสอบหรือมอบสิทธิ์เนื้อหา อย่างไรก็ตาม สำหรับการสมัครสมาชิก Amazon และ One Store ฟีเจอร์การเร่งเวลาในการสมัครสมาชิกจะไม่ได้รับการสนับสนุนแม้ในระหว่างการชำระเงินทดสอบ ดังนั้นจึงต้องมีการตรวจสอบในลักษณะเดียวกับการซื้อการสมัครสมาชิกเชิงพาณิชย์
  • URL ที่ร้องขอ
Production URL https://hiveiap.qpyou.cn/api_v4/verify_subscription
Sandbox URL https://sandbox-hiveiap.qpyou.cn/api_v4/verify_subscription
HTTP Method POST
HTTP Header Content-Type text/html
Authorization Bearer (optional)
  • โทเค็น Bearer สามารถใช้ได้เมื่อสถานะการตรวจสอบสิทธิ์ Hive เป็น Y ใน Hive Console > App Center > Game Management > Game List – Select Game Developer > Game Details > Basic Information.
  • โทเค็น Bearer จะตรงกับคีย์การตรวจสอบสิทธิ์ Hive ใน App Center > Game Management > Game List – Select Game Developer > Game Details > Basic Information.
Data Format JSON
  • คำขอ
ชื่อฟิลด์ คำอธิบาย ประเภท จำเป็น
purchase_bypass_info ข้อมูลเกี่ยวกับผู้ใช้ที่ทำการซื้อ, อุปกรณ์, และใบเสร็จที่ถูกดึงออกมาจาก Hive SDK.
เมื่อทำการซื้อในแอปด้วย Hive IAP v4, bypassInfo (ค่าที่อยู่ในรูปแบบ JSON ที่เข้ารหัสใน Base64) ของวัตถุ IAPV4Receipt ที่ถูกเรียกกลับจากวิธี purchaseSubscriptionupdate() หรือ restoreSubscription() ของคลาส Hive SDK v4 IAPV4 ควรจะถูกส่งในลำดับของ Hive SDK v4 → เกมไคลเอนต์ → เกมเซิร์ฟเวอร์ → เซิร์ฟเวอร์การตรวจสอบใบเสร็จการสมัครสมาชิก Hive IAP v4		 สตริง ใช่
  • การตอบสนอง
ชื่อฟิลด์ คำอธิบาย ประเภท จำเป็น
result รหัสการตอบกลับ
  • 0: การตรวจสอบความถูกต้องสำเร็จ
  • รหัสอื่น ๆ: การตรวจสอบความถูกต้องล้มเหลวหรือปัญหาการกำหนดค่าของ Hive IAP
จำนวนเต็ม ใช่
result_msg ข้อความการตอบกลับ สตริง ใช่
hiveiap_market_id รหัสประจำตัวสำหรับตลาดที่การชำระเงินถูกทำ
  • 1: Apple App Store
  • 2: Google Play Store
  • 5: Amazon Store
  • 7: Huawei Store
  • ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบความถูกต้องสำเร็จ)
จำนวนเต็ม ไม่ใช่
hiveiap_market_pid MARKET PID ที่ถูกดึงมาจากใบเสร็จหรือผลการตรวจสอบใบเสร็จ ซึ่งกำหนดว่าสิ่งใดควรจะมอบให้กับผู้ใช้แอป เมื่อใช้ค่านี้เพื่อมอบสิ่งของ อย่าใช้ MARKET PID ที่จัดเตรียมโดย SDK ในการเรียกกลับ แต่ต้องใช้ค่านี้ ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบความถูกต้องสำเร็จ) สตริง ไม่ใช่
hiveiap_receipt ค่าที่แปลงจากใบเสร็จที่สร้างขึ้นเป็นสตริงไปยังวัตถุ
เฉพาะ Apple App Store เท่านั้นที่ไม่สามารถสร้างวัตถุได้และจะถูกจัดเตรียมเป็นสตริง
ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบความถูกต้องสำเร็จ)		 Apple App Store: สตริง Google Play Store: วัตถุ ไม่ใช่
hiveiap_receipt_verify_result ผลการตรวจสอบใบเสร็จที่ส่งโดยเซิร์ฟเวอร์การตรวจสอบตลาด
วัตถุ ไม่ใช่
hiveiap_iap_payload ข้อมูลเมตาที่กำหนดโดยบริษัทเกม. จะส่งคืน null หากไม่มีข้อมูลเมตาที่กำหนด สตริง ไม่ใช่
hiveiap_receipt_cancel_date_ms เวลายกเลิกการสมัครสมาชิก (unix timestamp, ms). ค่าดีฟอลต์คือ 0 ยาว ไม่ใช่
hiveiap_receipt_refund_date_ms เวลาคืนเงิน (unix timestamp, ms). ค่าดีฟอลต์คือ 0 ยาว ไม่ใช่
hiveiap_receipt_start_date_ms เวลาที่เริ่มการสมัครสมาชิก (Unix TimeStamp Milliseconds).
ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบความถูกต้องสำเร็จ)		 ยาว ไม่ใช่
hiveiap_receipt_expire_date_ms เวลาหมดอายุการสมัครสมาชิก (Unix TimeStamp Milliseconds).
ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบความถูกต้องสำเร็จ)		 ยาว ไม่ใช่
hiveiap_receipt_subscription_state สถานะการสมัครสมาชิก
  • 0: การสมัครสมาชิกปกติ
  • 1: ระยะเวลาผ่อนผันการชำระเงิน
  • 2: การชำระเงินถูกระงับ
  • 3: หยุดชั่วคราว
  • 4: หมดอายุ ค่าจะถูกจัดเตรียมเฉพาะสำหรับการสมัครสมาชิก Google ปัจจุบัน (ตลาดอื่นตอบกลับด้วย 0) และตั้งแต่วันที่ 1 พฤศจิกายน 2020 นโยบายของ Google ได้เปลี่ยนแปลงเพื่อให้การสนับสนุนการกู้คืนการสมัครสมาชิกและการแจ้งเตือนการระงับการชำระเงิน (การระงับบัญชี) เพื่อตรวจสอบสถานะการสมัครสมาชิก
  • ระยะเวลาผ่อนผันการชำระเงิน: ขยายเวลาหมดอายุจนกว่าสถานะการชำระเงินของผู้ใช้จะกลับสู่ปกติ (ใช้ในระยะเวลาผ่อนผันที่ตั้งไว้ใน Google market console)
  • การชำระเงินถูกระงับ (การระงับบัญชี): เมื่อสถานะการชำระเงินของผู้ใช้ไม่กลับสู่ปกติและเวลาหมดอายุผ่านไป สิทธิ์ในการเข้าถึงเนื้อหาจะไม่ได้รับ แต่ถ้าสถานะการชำระเงินกลับสู่ปกติในภายหลัง เวลาหมดอายุการสมัครสมาชิกจะถูกขยาย (สูงสุด 30 วันของสถานะการระงับการชำระเงิน)
จำนวนเต็ม N
hiveiap_apple_info ข้อมูลสำคัญที่สามารถระบุใบเสร็จจากผลการตรวจสอบใบเสร็จการสมัครสมาชิกของ Apple ใช้ได้เฉพาะสำหรับใบเสร็จการสมัครสมาชิก App Store
ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบสำเร็จ)		 วัตถุ N
ㄴ original_transaction_id คีย์ที่สามารถระบุใบเสร็จการสมัครสมาชิกของ Apple
สำหรับผลิตภัณฑ์เดียวกันหรือผลิตภัณฑ์ภายในกลุ่มเดียวกันในบัญชีตลาด จะส่งค่าที่เหมือนกันเสมอแม้จะมีการอัปเกรด ลดระดับ ยกเลิก หรือซื้อใหม่ (16 ตัวอักษร และความยาวอาจแตกต่างกันเนื่องจากไม่มีคำอธิบายความยาวในคู่มือของ Apple)		 สตริง N
hiveiap_google_info ข้อมูลสำคัญที่สามารถระบุใบเสร็จจากผลการตรวจสอบใบเสร็จการสมัครสมาชิกของ Google
ใช้ได้เฉพาะสำหรับใบเสร็จการสมัครสมาชิก Play Store
ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบสำเร็จ)		 วัตถุ N
ㄴ purchase_token โทเค็นการซื้อของใบเสร็จ (มากกว่า 200 ตัวอักษร และความยาวอาจแตกต่างกันเนื่องจากไม่มีคำอธิบายความยาวในคู่มือของ Google) สตริง N
ㄴ purchase_token_hash ค่าที่สร้างจากการแฮชค่าฟิลด์ purchase_token (sha1)
เนื่องจากค่าของ purchase_token ยาว จึงคาดว่าจะมีความยากลำบากในการจัดเก็บและเรียกคืนในฐานข้อมูลของเกม ดังนั้นจึงจัดเตรียมหลังจากการแฮช (40 ตัวอักษร)		 สตริง N
ㄴ linked_purchase_token เมื่อใบเสร็จการสมัครสมาชิกถูกออกใหม่หลังจากการอัปเกรด ลดระดับ ยกเลิก หรือเปิดใช้งานในแอปอีกครั้ง ค่าฟิลด์นี้สามารถระบุโทเค็นการซื้อของใบเสร็จเก่าได้
หากมีค่าแนะนำให้บังคับให้ใบเสร็จเก่าหมดอายุ (มากกว่า 200 ตัวอักษร และความยาวอาจแตกต่างกันเนื่องจากไม่มีคำอธิบายความยาวในคู่มือของ Google)
อย่างไรก็ตามจะไม่ถูกออกใหม่เมื่อเปิดใช้งานใน Play Store		 สตริง N
ㄴ linked_purchase_token_hash ค่าที่สร้างจากการแฮชค่าฟิลด์ linked_purchase_token (sha1)
เนื่องจากค่าของ linked_purchase_token ยาว จึงคาดว่าจะมีความยากลำบากในการจัดเก็บและเรียกคืนในฐานข้อมูลของเกม ดังนั้นจึงจัดเตรียมหลังจากการแฮช (40 ตัวอักษร)		 สตริง N
hiveiap_amazon_info ข้อมูลสำคัญที่สามารถระบุใบเสร็จจากผลการตรวจสอบใบเสร็จการสมัครสมาชิกของ Amazon
ค่าจะถูกจัดเตรียมเฉพาะเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบสำเร็จ)		 วัตถุ N
ㄴ receipt_id หมายเลขใบเสร็จการซื้อ สตริง N
hiveiap_huawei_info ตอบกลับด้วยข้อมูลสำคัญที่สามารถระบุใบเสร็จในผลการตรวจสอบใบเสร็จการสมัครสมาชิกของ Huawei
จะให้ค่าก็ต่อเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบสำเร็จ)		 วัตถุ N
ㄴ pay_order_id หมายเลขใบเสร็จการซื้อ
เปลี่ยนค่าในทุกครั้งที่มีการเรียกเก็บเงินโดยอัตโนมัติ		 สตริง N
ㄴ purchase_token โทเค็นการซื้อของใบเสร็จ (มากกว่า 92 ตัวอักษร และความยาวอาจแตกต่างกันเนื่องจากไม่มีคำอธิบายความยาวในแนวทางของ Huawei)
เมื่อฟังก์ชันการซื้อกลุ่มการสมัครสมาชิกไม่ได้รับการสนับสนุน แม้ว่าจะมีการเรียกเก็บเงินโดยอัตโนมัติ หากบัญชีตลาดและผลิตภัณฑ์เหมือนกับการซื้อก่อนหน้านี้ โทเค็นจะยังคงเป็นค่าที่เหมือนกัน		 สตริง N
ㄴ purchase_token_hash ค่าที่สร้างจากการแฮชค่าฟิลด์ purchase_token (sha1) สตริง N
hiveiap_onestore_info ตอบกลับด้วยข้อมูลสำคัญที่สามารถระบุใบเสร็จในผลการตรวจสอบใบเสร็จการสมัครสมาชิกของ One Store
จะให้ค่าก็ต่อเมื่อรหัสการตอบกลับเป็น 0 (การตรวจสอบสำเร็จ)		 วัตถุ N
ㄴ purchase_id หมายเลขใบเสร็จการซื้อ
เปลี่ยนค่าในทุกครั้งที่มีการเรียกเก็บเงินโดยอัตโนมัติ		 สตริง N
hiveiap_account_uuid_compare สถานะการจับคู่ระหว่างข้อมูลบัญชีที่ส่งไปยัง API การตรวจสอบใบเสร็จและข้อมูลบัญชี Hive เมื่อทำการตรวจสอบใบเสร็จ บัญชี Hive หลายบัญชีอาจมีบัญชีตลาดเดียวกัน
1: ตรงกัน
2: ไม่ตรงกัน
9: ไม่รองรับ		 จำนวนเต็ม N
  • รหัสผลลัพธ์
รหัส ข้อความ คำอธิบาย
0 สำเร็จ การตรวจสอบความถูกต้องสำเร็จ
1000001 ไม่มีพารามิเตอร์ที่ร้องขอ เมื่อไม่มีการส่งพารามิเตอร์
1000003 ข้อผิดพลาดการเชื่อมต่อฐานข้อมูล เมื่อการเชื่อมต่อฐานข้อมูลล้มเหลว
1000005 ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน
1000006 ข้อมูลพารามิเตอร์ที่จำเป็นขาดหายไป เมื่อค่าพารามิเตอร์ที่จำเป็นขาดหายไป
1000503 ไม่สามารถตรวจสอบใบเสร็จได้ เมื่อการตรวจสอบใบเสร็จล้มเหลวหรือใบเสร็จถูกแฮ็ก (แฮ็กปลอม)
1000504 คีย์สาธารณะยังไม่ได้ลงทะเบียน เมื่อคีย์ใบอนุญาตที่จำเป็นสำหรับการตรวจสอบใบเสร็จจาก Google, Amazon, Huawei, และ One Store ยังไม่ได้ลงทะเบียน
1000507 ไม่สามารถบันทึกข้อมูลการซื้อได้ เมื่อไม่สามารถบันทึกประวัติการตรวจสอบการสมัครสมาชิกได้
1000516 เซิร์ฟเวอร์ตรวจสอบใบเสร็จผิดปกติ เมื่อมีปัญหากับเซิร์ฟเวอร์ตรวจสอบใบเสร็จในตลาด
1000517 ไม่สามารถค้นหาคีย์ส่วนตัวของ Google API ได้ เมื่อบัญชีบริการที่จำเป็นสำหรับการเรียกใช้ Google Developer API ยังไม่ได้ลงทะเบียนในศูนย์แอป
1000518 ไม่สามารถค้นหาคีย์ลับที่แชร์ได้ เมื่อคีย์ลับที่แชร์ที่จำเป็นสำหรับการตรวจสอบการสมัครสมาชิกของ Apple ยังไม่ได้ลงทะเบียนในศูนย์แอป
1000520 ไม่สามารถตรวจสอบ API Key ได้ การตรวจสอบ Bearer token ที่ออกโดยศูนย์แอปล้มเหลว
1000535 การตอบสนองของ Market API ถูกตอบกลับว่าไม่สำเร็จ เมื่อผลลัพธ์การตอบสนองของ Market API เป็นความล้มเหลว
1000540 ไม่พบข้อมูล App Store Connect เมื่อข้อมูลคีย์ API ของ App Store Connect ยังไม่ได้ลงทะเบียน
  • ตัวอย่างการโทร
curl -L -v 
-d '{"vid":"30000038691","purchase_bypass_info":"eyJtYXJrZ...J5IjoiS1IifQ==","game_info":"","item_type":"subscription","client_ip":"106.101.2.199","header":{"Expect":"100-continue","Content-Type":"application/x-www-form-urlencoded","Content-Length":"10417","Authorization":"bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc","Accept":"*/*","Host":"sandbox-hiveiap.qpyou.cn"}}' 
-H "Content-Type: text/html" 
-H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" 
https://sandbox-hiveiap.qpyou.cn/api_v4/verify_subscription

curl -L -v 
-d '{"vid":"10044749751","purchase_bypass_info":"eyJtYXJr...WXc9PSJ9","game_info":{"character_key":null},"header":{"Expect":"100-continue","Content-Type":"application/x-www-form-urlencoded","Content-Length":"2334","Authorization":"bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc"}}' 
-H "Content-Type: text/html" 
-H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" 
https://sandbox-hiveiap.qpyou.cn/api_v4/verify_subscription

curl -L -v 
-d '{"vid":"105276147","purchase_bypass_info":"eyJtYX...iOjB9fQ==","game_info":{"character_key":null},"header":{"Expect":"100-continue","Content-Type":"application/x-www-form-urlencoded","Content-Length":"1272","Authorization":"bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc"}}' 
-H "Content-Type: text/html" 
-H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" 
https://sandbox-hiveiap.qpyou.cn/api_v4/verify_subscription

curl -L -v 
-d '{"vid":"30000057197","purchase_bypass_info":"eyJ...3PT0ifQ==","game_info":"{"character_key":"kr_12345_1"}","item_type":"subscription","client_ip":"220.70.82.100","header":{"Expect":"100-continue","Content-Type":"application/x-www-form-urlencoded","Content-Length":"2528","Authorization":"bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc"}}' 
-H "Content-Type: text/html" 
-H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" 
https://sandbox-hiveiap.qpyou.cn/api_v4/verify_subscription

curl -L -v 
-d '{"vid":"40099403","purchase_bypass_info":"eyJtYX...0IjowfX0=","game_info":{"character_key":null},"header":{"Expect":"100-continue","Content-Type":"application/x-www-form-urlencoded","Content-Length":"3323","Authorization":"bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc"}}' 
-H "Content-Type: text/html" 
-H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" 
https://sandbox-hiveiap.qpyou.cn/api_v4/verify_subscription

curl -L -v 
-d '{"session_token":"6a28b...0ifQ==","game_info":"{"price":"1100","additionalInfo":"{"character_key":"kr_12345_1"}"}","item_type":"subscription","header":{"Content-Length":"2178","Accept":"*/*","Authorization":"Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc"}}' 
-H "Content-Type: text/html" 
-H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" 
https://sandbox-hiveiap.qpyou.cn/api_v4/verify_subscription

ตัวอย่างการร้องขอ

> POST /api_v4/verify_subscription HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: */*
> content-type: text/html
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> content-length: 10753

> POST /api_v4/verify_subscription HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: */*
> content-type: text/html
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> content-length: 2619

> POST /api_v4/verify_subscription HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: */*
> content-type: text/html
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> content-length: 1557

> POST /api_v4/verify_subscription HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: */*
> content-type: text/html
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> content-length: 2813

> POST /api_v4/verify_subscription HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: */*
> content-type: text/html
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> content-length: 3608

> POST /api_v4/verify_subscription HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: */*
> content-type: text/html
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> content-length: 2384

ตัวอย่างการตอบกลับ

< HTTP/2 200
< server: nginx
< date: Thu, 24 Mar 2022 07:01:00 GMT
< content-type: text/html; charset=utf-8

< HTTP/2 200
< server: nginx
< date: Wed, 23 Mar 2022 04:59:05 GMT
< content-type: text/html; charset=utf-8
{"result":0,"result_msg":"success","hiveiap_market_id":2,"hiveiap_market_pid":"sub01","hiveiap_receipt":{"purchase_data":{"orderId":"GPA.3300-6740-3472-70794","packageName":"com.com2us.hivesdk.normal.freefull.google.global.android.common","productId":"sub01","purchaseTime":1647584315806,"purchaseState":0,"purchaseToken":"eagfmnlgeplpniofclfepanm.AO-J1Ow40S88Ctyqd4kPS5YjhItqiNd4NqbJgRuqhgu8prloZel9CKyJQzvE_qkR8j4Pp-c060jj1QBQ7bU1cTXpP2-Md70jawN9T_gWezOhDAoqhWDwovUfFoVTx0Paa0DNJUwKhmnsIKNroWpKaAnf4jVVelvgvg","obfuscatedAccountId":"4a1707b0720f695724c1265cea1626e5d8561ef1e4a12073a9174c94bba85fb9","autoRenewing":true,"acknowledged":false,"developerPayload":null},"signature":"meW5ORdbF2aXiQtCbTwJMdDivnKvb0m9989b7+hCo3BuANcmgeSNydD5761LJ5YDWNpPtSLvZHIuSbUyS43CcPmcomd5c1O2ylHuTqyHiSeqpGq/FpZj3nRy2Y9oSXku90MNXFmzIpevy3HDuhVtexdRBz/H7zYG/Co/qYXP9lIHSUxzKtZXG9eVulK+ASnGn0UHlY2TcKn8WUV0brj9oed0Ic/D10JrGGzUPsKrqO2jEnI4AE4boz9wOLpXzZ18bRSMBjweZdOGo1cBbX4v7pWNJkKGhNEvbs2vtikFRCsVn2zF0bCW0QAWAjUdmx/DTonD781l6xm9lIQYua41/Q=="},"hiveiap_receipt_verify_result":{"startTimeMillis":"1647584315806","expiryTimeMillis":"1647586296990","autoRenewing":false,"priceCurrencyCode":"KRW","priceAmountMicros":"1100000000","countryCode":"KR","developerPayload":"","cancelReason":1,"orderId":"GPA.3300-6740-3472-70794..5","purchaseType":0,"acknowledgementState":1,"kind":"androidpublisher#subscriptionPurchase","obfuscatedExternalAccountId":"4a1707b0720f695724c1265cea1626e5d8561ef1e4a12073a9174c94bba85fb9"},"hiveiap_receipt_start_date_ms":"1647584315806","hiveiap_receipt_expire_date_ms":"1647586296990","hiveiap_receipt_subscription_state":4,"hiveiap_google_info":{"purchase_token_hash":"cd9de91a1a7ba61237504d8c15dc2ba18030ddbc","purchase_token":"eagfmnlgeplpniofclfepanm.AO-J1Ow40S88Ctyqd4kPS5YjhItqiNd4NqbJgRuqhgu8prloZel9CKyJQzvE_qkR8j4Pp-c060jj1QBQ7bU1cTXpP2-Md70jawN9T_gWezOhDAoqhWDwovUfFoVTx0Paa0DNJUwKhmnsIKNroWpKaAnf4jVVelvgvg","linked_purchase_token":"","linked_purchase_token_hash":""}}

< HTTP/2 200
< server: nginx
< date: Wed, 23 Mar 2022 06:19:35 GMT
< content-type: text/html; charset=utf-8
{"result":0,"result_msg":"success","hiveiap_market_id":5,"hiveiap_market_pid":"sub001","hiveiap_receipt":{"userId":"4WYIUB3WVEon97SvYnYH3tzrYV7ik7wn95cGAqMgXss=","marketPlace":"US","receiptId":"oJivzQ44BXF6dksfs_b29yehk1On42DQm_sdeWflzWI=:3:11","sku":"sub001","productType":"SUBSCRIPTION","purchaseDate":"Fri Dec 24 16:20:07 GMT+09:00 2021","cancelDate":null,"purchase_data":null},"hiveiap_receipt_verify_result":{"autoRenewing":true,"betaProduct":true,"cancelDate":null,"cancelReason":null,"deferredDate":null,"deferredSku":null,"freeTrialEndDate":null,"gracePeriodEndDate":null,"parentProductId":null,"productId":"sub001","productType":"SUBSCRIPTION","purchaseDate":1640330407000,"purchaseMetadataMap":null,"quantity":null,"receiptId":"oJivzQ44BXF6dksfs_b29yehk1On42DQm_sdeWflzWI=:3:11","renewalDate":1648192807000,"term":"1 Week","termSku":"sub001_1","testTransaction":true},"hiveiap_receipt_start_date_ms":1640330407000,"hiveiap_receipt_expire_date_ms":1648192807000,"hiveiap_receipt_subscription_state":0,"hiveiap_amazon_info":{"receipt_id":"oJivzQ44BXF6dksfs_b29yehk1On42DQm_sdeWflzWI=:3:11"}}

< HTTP/2 200
< server: nginx
< date: Thu, 24 Mar 2022 07:08:33 GMT
< content-type: text/html; charset=utf-8
{"result":0,"result_msg":"success","hiveiap_market_id":6,"hiveiap_market_pid":"sub01","hiveiap_receipt":{"purchaseData":"{"mItemId":"sub01","mItemName":"sub01 week","mItemDesc":"sub01 week, free trial period 7days","mItemPrice":1135,"mItemPriceString":"uffe61,135","mType":"subscription","mConsumableYN":"N","mCurrencyUnit":"uffe6","mCurrencyCode":"KRW","mItemImageUrl":"https://img.samsungapps.com/appsitem/itemDefaultImage.jpg","mItemDownloadUrl":"","mReserved1":"","mReserved2":"","mOrderId":"P20220324KR82354262","mPaymentId":"TPMTID20220324KR82354262","mPurchaseId":"ea2c6d13654e294bda8efa1836e1b91e983aebe27fca8c76f14c4f2482b715b7","mPassThroughParam":"eyJjaGFyYWN0ZXJfa2V5Ijoia3JfMTIzNDVfMSJ9","mVerifyUrl":"https://iap.samsungapps.com/iap/getPurchaseReceipt.as?protocolVersion=5.0","mUdpSignature":"","mPurchaseDate":"2022-03-24 14:03:27"}","purchaseId":"ea2c6d13654e294bda8efa1836e1b91e983aebe27fca8c76f14c4f2482b715b7","purchase_data":{"mItemId":"sub01","mItemName":"sub01 week","mItemDesc":"sub01 week, free trial period 7days","mItemPrice":1135,"mItemPriceString":"uffe61,135","mType":"subscription","mConsumableYN":"N","mCurrencyUnit":"uffe6","mCurrencyCode":"KRW","mItemImageUrl":"https://img.samsungapps.com/appsitem/itemDefaultImage.jpg","mItemDownloadUrl":"","mReserved1":"","mReserved2":"","mOrderId":"P20220324KR82354262","mPaymentId":"TPMTID20220324KR82354262","mPurchaseId":"ea2c6d13654e294bda8efa1836e1b91e983aebe27fca8c76f14c4f2482b715b7","mPassThroughParam":"eyJjaGFyYWN0ZXJfa2V5Ijoia3JfMTIzNDVfMSJ9","mVerifyUrl":"https://iap.samsungapps.com/iap/getPurchaseReceipt.as?protocolVersion=5.0","mUdpSignature":"","mPurchaseDate":"2022-03-24 14:03:27","developerPayload":null}},"hiveiap_receipt_verify_result":{"itemId":"sub01","paymentId":"TPMTID20220324KR82354262","orderId":"P20220324KR82354262","packageName":"com.com2us.hivesdk.android.galaxystore.global.normal","itemName":"sub01 week","itemDesc":"sub01 week, free trial period 7days","purchaseDate":"2022-03-24 05:03:27","paymentAmount":"1135.0","status":"success","paymentMethod":"Credit Card","mode":"TEST","consumeYN":"N","consumeDate":"","consumeDeviceModel":"","passThroughParam":"{"character_key":"kr_12345_1"}","currencyCode":"KRW","currencyUnit":"uffe6","subscription_result":"{"subscriptionPurchaseDate":"2022-03-24 05:03:27","subscriptionEndDate":"2022-06-23 05:03:27","subscriptionType":"Item_Type_Auto_Recurring_Subscription","subscriptionStatus":"ACTIVE","subscriptionFirstPurchaseID":"ea2c6d13654e294bda8efa1836e1b91e983aebe27fca8c76f14c4f2482b715b7","countryCode":"KOR","localCurrencyCode":"KRW","localPrice":"1135.000","supplyPrice":"1135.000","itemID":"sub01","freeTrial":"N","realMode":"N","latestOrderId":"P20220324KR82364801","totalNumberOfTieredPayment":"0","currentPaymentPlan":"R","totalNumberOfRenewalPayment":"13","subscriptionFirstPaymentDate":"2022-03-24 05:03:28"}"},"hiveiap_receipt_start_date_ms":1648098207,"hiveiap_receipt_expire_date_ms":1655960607,"hiveiap_receipt_subscription_state":0,"hiveiap_galaxystore_info":{"purchase_id":"ea2c6d13654e294bda8efa1836e1b91e983aebe27fca8c76f14c4f2482b715b7","order_id":"P20220324KR82354262","payment_id":"TPMTID20220324KR82354262"}}

< HTTP/2 200
< server: nginx
< date: Thu, 24 Mar 2022 06:58:55 GMT
< content-type: text/html; charset=utf-8
{"result":0,"result_msg":"สำเร็จ","hiveiap_market_id":7,"hiveiap_market_pid":"sub01","hiveiap_receipt":{"purchase_data":{"autoRenewing":true,"subIsvalid":true,"orderId":"1648102638745.03262E6E.4128","lastOrderId":"L1648102638745.03262E6E.4128","packageName":"com.com2us.hivesdk.android.huawei.global.normal.huawei","applicationId":102032079,"productId":"sub01","kind":2,"productName":"sub01 week group1","productGroup":"0ED18D0FB04A4871A49D4B5B54F94F6A","purchaseTime":1648102648345,"oriPurchaseTime":1648102648345,"purchaseState":0,"developerPayload":null,"purchaseToken":"0000017fba92849908fa90c046980352f2ae95be934ff170d54adf9022732f2b71d59b05f6c05a35x4652.7.4128","purchaseType":0,"currency":"EUR","price":100,"country":"FR","subscriptionId":"1648102638745.C8A25D67.4128","quantity":1,"daysLasted":0,"numOfPeriods":1,"numOfDiscount":0,"expirationDate":1648102828345,"retryFlag":1,"introductoryFlag":0,"trialFlag":0,"renewStatus":1,"renewPrice":100,"cancelledSubKeepDays":30,"payOrderId":"SandBox_1648102638745.03262E6E.4128","payType":"0","confirmed":1,"sdkChannel":"1"},"signature":"BeeX2A6COgGqIPUYLm6risigQBvJ2IMAAnsrNUzc3QguQh+4A6+Gci2BPUhS6jKGUVQZoZ8rQWJ2lQwTMtt5/p/l+BadR2w70kqkxf60ezJW1HwjoBRs7uNM50o73FBOx+hZaAlZJg2T+xye9d56+yDMg3g+EaHoPHRkHlRd25O4uoWF4A6HQNW3QHqBFLecmb9nvtSd+HdIZYK0AmWKP1tQ2J7bhQKjtvXuiTAKBlrEOY/emtun+zoNa3XMkIF4EV960PSw4xa/dlE/iHkMABqZQAsBx1B0XQA9aQP9guvYamtbrh7gwv2jUyqsfm8wl1XvocEbPjfZ5HtMjF+K4Bw6MCaDnKyKy9YrY8uaYugQFTxfZzwi9XaLyeAX/+vaBwnkBMbPAkieXipZjXycT8qZHSZm8VIkY5Efxlxn00hK2eQWYqGt1R16A8p7lAW1mxCPuhuLLFxXZfF3yxKQdemnsIWB6aNK80ZTN9Ue6LhRdzYt58LkMN49ifKC30VI"},"hiveiap_receipt_verify_result":{"responseCode":"0","inappPurchaseData":{"autoRenewing":true,"subIsvalid":false,"orderId":"1648103352172.32DE0455.4128","lastOrderId":"1648103168069.8F3CCBC0.4128","packageName":"com.com2us.hivesdk.android.huawei.global.normal.huawei","applicationId":102032079,"productId":"sub01","kind":2,"productName":"sub01 week group1","productGroup":"0ED18D0FB04A4871A49D4B5B54F94F6A","purchaseTime":1648103548345,"oriPurchaseTime":1648102648345,"purchaseState":0,"developerPayload":"","purchaseToken":"0000017fba92849908fa90c046980352f2ae95be934ff170d54adf9022732f2b71d59b05f6c05a35x4652.7.4128","purchaseType":0,"currency":"EUR","price":100,"country":"FR","subscriptionId":"1648102638745.C8A25D67.4128","quantity":1,"daysLasted":5,"numOfPeriods":6,"numOfDiscount":0,"expirationDate":1648103728345,"retryFlag":1,"introductoryFlag":0,"trialFlag":0,"renewStatus":1,"renewPrice":100,"cancelledSubKeepDays":30,"payOrderId":"SandBox_1648103352172.32DE0455.4128","payType":"0","confirmed":1,"sdkChannel":"1"}},"hiveiap_receipt_start_date_ms":1648103548345,"hiveiap_receipt_expire_date_ms":1648103728345,"hiveiap_receipt_subscription_state":0,"hiveiap_huawei_info":{"pay_order_id":"SandBox_1648103352172.32DE0455.4128","purchase_token":"0000017fba92849908fa90c046980352f2ae95be934ff170d54adf9022732f2b71d59b05f6c05a35x4652.7.4128","purchase_token_hash":"17ba67d7f93e113969a3942dc6c196d679118388"}}

< HTTP/2 200
< server: nginx
< date: Wed, 23 Mar 2022 06:13:09 GMT
< content-type: text/html; charset=utf-8
{"result":0,"result_msg":"success","hiveiap_market_id":4,"hiveiap_market_pid":"sub001","hiveiap_receipt":{"purchase_data":{"orderId":"ONESTORE7_000000000000000000000001556616","packageName":"com.com2us.hivesdk.normal.freefull.onestore.kr.android.common","productId":"sub001","purchaseTime":1647508188643,"purchaseId":"SANDBOX3000001558614","purchaseToken":"SANDBOXT000001558614","developerPayload":"{"price":"1100","additionalInfo":"{"character_key":"kr_12345_1"}"}"},"signature":"Je3I3gk+QvEQlOdxDvBonHndgBseNcaaOChRyFiCBkewhzLy0WVLV7wQyTZiS+YVDst5x/7URuzDyN6Av+GYi7RD61hdqjCHAxhNGbkVQr43SW9v5OdqI+vCqwmBLKe4bXrswI5asMD/qziyWrY0H2vT36B8k0WKKHTbMgxwJwY="},"hiveiap_receipt_verify_result":{"startTime":1647508188000,"expiryTime":1650186588000,"nextPaymentTime":1650186584400,"autoRenewing":true,"cancelReason":0,"cancelledTime":0,"acknowledgeState":1,"lastPurchaseId":"SANDBOX3000001558614","lastPurchaseState":0},"hiveiap_receipt_start_date_ms":1647508188000,"hiveiap_receipt_expire_date_ms":1650186588000,"hiveiap_receipt_subscription_state":0,"hiveiap_onestore_info":{"purchase_id":"SANDBOX3000001558614"}}