วงจรการสมัครใช้บริการ

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

จัดการวงจรของการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติ

เมื่อสถานะการสมัครใช้บริการของผู้ใช้เปลี่ยนแปลง เซิร์ฟเวอร์แบ็กเอนด์จะได้รับข้อความ SubscriptionNotification

subs-auto-renew-state
รูปที่ 1 สถานะวงจรและเหตุการณ์การเปลี่ยนสถานะสำหรับการซื้อการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติ

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

โทเค็นการซื้อจะใช้ได้ตั้งแต่การลงชื่อสมัครใช้บริการจนถึง 60 วันหลังจากหมดอายุ หลังจากวันที่ดังกล่าว โทเค็นการซื้อจะใช้ไม่ได้อีกต่อไปสำหรับการเรียกใช้ Google Play Developer API

การซื้อการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติรายการใหม่

เมื่อผู้ใช้ซื้อการสมัครใช้บริการ ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PURCHASED ไปยังไคลเอ็นต์ RTDN ของคุณ ไม่ว่าคุณจะได้รับการแจ้งเตือนนี้หรือลงทะเบียนการซื้อใหม่ในแอปผ่าน PurchasesUpdatedListener หรือการดึงข้อมูลการซื้อด้วยตนเองในเมธอด onResume() ของแอป คุณควรประมวลผลการซื้อใหม่ในแบ็กเอนด์ที่ปลอดภัย โดยทำตามขั้นตอนต่อไปนี้

  1. ค้นหาปลายทาง purchases.subscriptionsv2.get เพื่อรับทรัพยากรการสมัครใช้บริการที่มีสถานะการสมัครใช้บริการล่าสุด
  2. ตรวจสอบว่าค่าของช่อง subscriptionState เป็น SUBSCRIPTION_STATE_ACTIVE
  3. ยืนยันการซื้อ
  4. ให้สิทธิ์ผู้ใช้เข้าถึงเนื้อหา คุณสามารถระบุบัญชีผู้ใช้ที่เชื่อมโยงกับการซื้อได้ด้วยออบเจ็กต์ ExternalAccountIdentifiers จากทรัพยากรการสมัครใช้บริการ หากมีการตั้งค่าตัวระบุไว้ ณ เวลาที่ซื้อโดยใช้ setObfuscatedAccountId และ setObfuscatedProfileId

ช่อง offerPhase ใน SubscriptionPurchaseLineItem จะให้รายละเอียดเกี่ยวกับเฟสปัจจุบันของการสมัครใช้บริการ เช่น ช่วงทดลองใช้ฟรีหรือราคาช่วงแนะนำ

นอกจากนี้ Play Billing Library ยังมีเมธอดเพื่อรับทราบการสมัครใช้บริการ acknowledgePurchase() และเมธอดเพื่อตรวจสอบสถานะการรับทราบ isAcknowledged() อย่างไรก็ตาม เราขอแนะนำให้คุณจัดการการประมวลผลการซื้อในแบ็กเอนด์เพื่อความปลอดภัยที่ดียิ่งขึ้น

ทรัพยากรการสมัครใช้บริการสำหรับการซื้อใหม่จะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  "startTime": "2022-04-22T18:39:58.270Z",
  "regionCode": "US",
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "latestOrderId": "GPA.3333-4137-0319-36762",
  "acknowledgementState": "ACKNOWLEDGEMENT_STATE_PENDING", // need to acknowledge new purchases
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      },
      "offerPhase": {
        "freeTrial": {}
      }
    }
  ],
}

การต่ออายุการสมัครใช้บริการ

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

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  "startTime": "2022-04-22T18:39:58.270Z",
  "regionCode": "US",
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "latestOrderId": "GPA.3333-4137-0319-36762",
  "acknowledgementState": "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED",
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      },
      "offerPhase": {
        "basePrice": {}
      }
    }
  ]
}

คุณไม่จำเป็นต้องรับทราบการต่ออายุการสมัครใช้บริการ

ระยะเวลาผ่อนผัน

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

เมธอด queryPurchasesAsync() จะยังคงแสดงการซื้อที่อยู่ในระยะเวลาผ่อนผันต่อไป หากแอปของคุณใช้ queryPurchasesAsync เพียงอย่างเดียวในการตรวจสอบว่าผู้ใช้มีสิทธิ์ในการสมัครใช้บริการหรือไม่ แอปควรจัดการระยะเวลาผ่อนผันโดยอัตโนมัติ เนื่องจากการสมัครใช้บริการเหล่านี้จะแสดงเป็น "ใช้งานอยู่" ผ่าน Play Billing Library

การซิงค์สถานะการสมัครใช้บริการกับแบ็กเอนด์ช่วยให้คุณทราบถึงการปฏิเสธการชำระเงินได้มากขึ้น และให้บริบทเพิ่มเติมเมื่อคุณพยายามลดการเลิกใช้งานโดยไม่สมัครใจ ฟังข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_IN_GRACE_PERIOD เพื่อรับการแจ้งเตือนเมื่อผู้ใช้เข้าสู่ระยะเวลาผ่อนผัน ขณะที่ผู้ใช้อยู่ในระยะเวลาผ่อนผัน ทรัพยากรการสมัครใช้บริการจะมี autoRenewEnabled = true Google Play จะขยายค่า expiryTime แบบไดนามิกจนกว่าระยะเวลาผ่อนผันจะหมดอายุ เนื่องจากสิทธิ์ควรคงอยู่จนกว่าผู้ใช้จะยกเลิกหรือระยะเวลาผ่อนผันสิ้นสุดลงตามระยะเวลาสูงสุด ค่าของช่อง subscriptionState ในช่วงเวลานี้คือ SUBSCRIPTION_STATE_IN_GRACE_PERIOD ทรัพยากรการสมัครใช้บริการจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_IN_GRACE_PERIOD",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_future,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

Play จะแจ้งให้ผู้ใช้ที่อยู่ในระยะเวลาผ่อนผันทราบว่าการชำระเงินถูกปฏิเสธ และแจ้งให้ผู้ใช้แก้ไขปัญหาเกี่ยวกับวิธีการชำระเงินใน Play Store เมื่อผู้ใช้เข้าสู่ระยะเวลาผ่อนผัน คุณควรแนะนำให้ผู้ใช้แก้ไขวิธีการชำระเงินด้วยในกรณีที่การชำระเงินล้มเหลวโดยไม่ตั้งใจ วิธีที่ตรงไปตรงมาในการดำเนินการนี้คือการใช้ In-App Messaging API หากคุณเรียกใช้ API นี้เมื่อผู้ใช้เปิดแอป ระบบจะแสดงข้อความ Play ในแถบแสดงสถานะชั่วคราวเพื่อแจ้งให้ผู้ใช้ทราบว่าการชำระเงินถูกปฏิเสธ ข้อความนี้ยังมี Deep Link สำหรับให้ผู้ใช้แก้ไขวิธีการชำระเงินใน Google Play ด้วย

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

หากผู้ใช้ไม่แก้ไขวิธีการชำระเงินในช่วงระยะเวลาผ่อนผัน การสมัครใช้บริการจะเข้าสู่สถานะการระงับบัญชี และผู้ใช้จะสูญเสียสิทธิ์

การเข้าถึงและการกู้คืนในช่วงระยะเวลาผ่อนผัน

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

รูปที่ 2 ไทม์ไลน์สำหรับการสมัครใช้บริการที่เข้าสู่ระยะเวลาผ่อนผันและกู้คืนก่อนสิ้นสุดระยะเวลาผ่อนผัน

สิ่งสำคัญที่ควรคำนึงถึงมีดังนี้

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

ระยะเวลาผ่อนผันแบบเงียบ

คุณสามารถตั้งค่าระยะเวลาผ่อนผันเป็น 0 วันได้ แต่ Play จะรออย่างน้อย 1 วันเพื่อให้มีเวลาเพียงพอสำหรับการลองชำระเงินอีกครั้ง ระยะเวลาผ่อนผันแบบไม่มีการแจ้งเตือนนี้เป็นเหมือนตาข่ายนิรภัยสำหรับการประมวลผลการชำระเงิน ในระหว่างระยะเวลา 24 ชั่วโมงนี้ การสมัครใช้บริการจะยังคงอยู่ในสถานะ ACTIVE

วิธีที่ดีที่สุดในการติดตามการเปลี่ยนแปลงสถานะการสมัครใช้บริการคือการฟังและตอบสนองต่อการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป (RTDN) เรียกใช้เมธอด purchases.subscriptionsv2.get() ณ เวลาที่ได้รับ RTDN แทนเวลาหมดอายุเพื่อรับสถานะการสมัครใช้บริการที่แม่นยำยิ่งขึ้น

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

  • SUBSCRIPTION_ON_HOLD (หากเปิดใช้)
  • SUBSCRIPTION_CANCELED (หากยกเลิก)
  • SUBSCRIPTION_EXPIRED (หากหมดอายุ)
  • SUBSCRIPTION_RENEWED (หากต่ออายุสำเร็จ)

นอกจากนี้ คุณยังเรียกใช้เมธอด subscriptionV2.get() ได้ทุกเมื่อหลังจากระยะเวลาผ่อนผันแบบไม่มีการแจ้งเตือน 24 ชั่วโมงเพื่อดูสถานะล่าสุดของการสมัครใช้บริการ

การระงับบัญชี

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

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

RTDN จะแจ้งให้คุณทราบเมื่อผู้ใช้เข้าสู่ช่วงการระงับบัญชี เพื่อให้คุณแจ้งผู้ใช้ได้โดยเร็วที่สุดถึงสาเหตุที่ระงับสิทธิ์เข้าถึงการสมัครใช้บริการ วิธีที่ตรงไปตรงมาในการดำเนินการนี้คือการใช้ In-App Messaging API การเรียกใช้ API นี้เมื่อผู้ใช้เปิดแอปจะแสดงข้อความในแถบแสดงสถานะชั่วคราวเพื่อแจ้งให้ผู้ใช้ทราบว่าการชำระเงินถูกปฏิเสธ ข้อความนี้ยังมี Deep Link สำหรับให้ผู้ใช้แก้ไขวิธีการชำระเงินใน Google Play ด้วย

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

เมธอด queryPurchasesAsync() จะไม่แสดงการสมัครใช้บริการในระหว่างการระงับบัญชี ดังนั้นหากแอปของคุณอาศัยเมธอดนี้ในการแสดงการซื้อที่มีอยู่ คุณควรสนับสนุนการระงับบัญชีโดยค่าเริ่มต้น

เมื่อใช้การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป คุณจะได้รับข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_ON_HOLD เมื่อการสมัครใช้บริการเข้าสู่สถานะระงับบัญชี เรียกใช้เมธอด purchases.subscriptionsv2.get จากเซิร์ฟเวอร์แบ็กเอนด์ที่ปลอดภัยเพื่อดึงข้อมูลการสมัครใช้บริการใหม่ ในระหว่างการระงับบัญชี ระบบจะตั้งค่าช่อง expiryTime ของทรัพยากรการสมัครใช้บริการเป็นการประทับเวลาที่ผ่านมา และตั้งค่าช่อง subscriptionState เป็น SUBSCRIPTION_STATE_ON_HOLD ดังนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ON_HOLD",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_past,
      ...
    }
  ],
}

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

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

สำหรับการสมัครใช้บริการแบบผ่อนชำระ การปฏิเสธการชำระเงินและการกู้คืนอาจเกิดขึ้นได้ในความพยายามชำระเงินแต่ละครั้ง

หลังจากกู้คืนแล้ว Play Billing Library จะแสดงการสมัครใช้บริการอีกครั้งผ่านเมธอด queryPurchasesAsync() หากคุณใช้วิธีนี้เพื่อพิจารณาว่าผู้ใช้มีสิทธิ์ในการสมัครใช้บริการหรือไม่ แอปของคุณควรจัดการการกู้คืนการสมัครใช้บริการจากการระงับบัญชีโดยอัตโนมัติ

ฟังข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_RECOVERED เพื่อรับการแจ้งเตือนเมื่อมีการกู้คืนการสมัครใช้บริการและผู้ใช้ควรได้รับสิทธิ์เข้าถึงอีกครั้ง หากคุณค้นหาการสมัครใช้บริการหลังจากได้รับการแจ้งเตือนนี้ ระบบจะตั้งค่าช่อง expiryTime เป็นการประทับเวลาในอนาคต และตั้งค่าช่อง subscriptionState เป็น SUBSCRIPTION_STATE_ACTIVE อีกครั้ง ดังนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      ...
    }
  ],
}

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

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_CANCELED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_past,
      ...
    }
  ],
}

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

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

สิทธิ์เข้าถึงและการกู้คืนการระงับบัญชี

รูปที่ 3 แสดงไทม์ไลน์สำหรับการสมัครใช้บริการที่เข้าสู่การระงับบัญชี แล้วกู้คืนเมื่อผู้ใช้แก้ไขวิธีการชำระเงิน

รูปที่ 3 ไทม์ไลน์สำหรับการสมัครใช้บริการที่เข้าสู่สถานะการระงับบัญชีและกู้คืนก่อนที่การสมัครใช้บริการจะสิ้นสุดลง

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

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

สิ่งสำคัญที่ควรคำนึงถึงมีดังนี้

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

วันหมดอายุ

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

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_EXPIRED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time_in_past,
      ...
    }
  ],
}

การยกเลิก

ผู้ใช้สามารถยกเลิกการสมัครใช้บริการจากศูนย์การสมัครใช้บริการของ Play ได้ด้วยตนเอง หรือระบบจะยกเลิกการสมัครใช้บริการโดยอัตโนมัติหากผู้ใช้ไม่กู้คืนหลังจากที่อยู่ในสถานะการระงับบัญชี นักพัฒนาแอปยังทริกเกอร์การยกเลิกด้วย purchases.subscriptionsv2.cancel ได้ด้วย เมื่อยกเลิกการสมัครใช้บริการแล้ว ผู้ใช้จะยังคงเข้าถึงเนื้อหาได้จนถึงสิ้นสุดรอบการเรียกเก็บเงินปัจจุบัน เมื่อรอบการเรียกเก็บเงินสิ้นสุดลง ระบบควรเพิกถอนสิทธิ์เข้าถึง

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

ทรัพยากรการสมัครใช้บริการสำหรับการซื้อที่ยกเลิกจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_CANCELED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time,
      ...
    }
  ],
}

สำหรับการสมัครใช้บริการแบบผ่อนชำระ ระบบจะส่งการแจ้งเตือน SUBSCRIPTION_CANCELLATION_SCHEDULED เมื่อผู้ใช้เริ่มการยกเลิกในขณะที่ยังคงมีการชำระเงินสำหรับระยะเวลาผูกมัด การยกเลิกอยู่ระหว่างรอดำเนินการและจะมีผลเมื่อสิ้นสุดระยะเวลาผูกมัดปัจจุบัน เมื่อคุณได้รับการแจ้งเตือนนี้ ทรัพยากรการสมัครใช้บริการที่แสดงผลจาก Google Play Developer API จะมีช่อง subscriptionState ที่ตั้งค่าเป็น SUBSCRIPTION_STATE_ACTIVE เนื่องจากยังมีการสมัครใช้บริการแบบผ่อนชำระอยู่จนกว่าจะสิ้นสุดระยะเวลาผูกมัด อย่างไรก็ตาม มีออบเจ็กต์ pendingCancellation ที่ว่างเปล่าอยู่ ระบบจะส่งการแจ้งเตือน SUBSCRIPTION_CANCELED ตามด้วย SUBSCRIPTION_EXPIRED เมื่อสิ้นสุดระยะเวลาผูกมัด

ทรัพยากรการสมัครใช้บริการสำหรับการซื้อการสมัครใช้บริการแบบผ่อนชำระที่รอการยกเลิกจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_plan01",
      "expiryTime": expiration_time,
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "recurringPrice": {
          "currencyCode": "USD",
          "units": "1",
          "nanos": 990000000
        },
        "installmentDetails": {
          "initialCommittedPaymentsCount": 6,
          "remainingCommittedPaymentsCount": 5,
          "pendingCancellation": {}
      ...
        }
      }
    }
  ],
}

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

เมื่อมีการยกเลิกการสมัครใช้บริการแต่ยังไม่หมดอายุ ระบบจะยังคงแสดงผลการสมัครใช้บริการดังกล่าวจาก queryPurchasesAsync() คุณอาจต้องการแสดงข้อความในแอปเพื่อแจ้งให้ผู้ใช้ทราบว่าการสมัครใช้บริการถูกยกเลิกแล้วและระบุวันที่หมดอายุ

การเพิกถอน

การสมัครใช้บริการอาจถูกเพิกถอนได้จากหลายสาเหตุ ซึ่งรวมถึงแบ็กเอนด์ของคุณเพิกถอนการสมัครใช้บริการโดยใช้ purchases.subscriptionsv2.revoke หรือการซื้อถูกดึงเงินคืน ในกรณีนี้ ให้เพิกถอนสิทธิ์ของผู้ใช้ทันที ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_REVOKED เมื่อเกิดเหตุการณ์นี้ขึ้น เมื่อได้รับการแจ้งเตือนนี้ ทรัพยากรการสมัครใช้บริการที่แสดงผลจาก Google Play Developer API จะมีช่อง subscriptionState ที่ตั้งค่าเป็น SUBSCRIPTION_STATE_EXPIRED

ทรัพยากรการสมัครใช้บริการสำหรับการซื้อที่เพิกถอนจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_EXPIRED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time,
      ...
    }
  ]
}

การสมัครใช้บริการที่เลื่อนเวลาออกไป

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

คุณใช้ purchases.subscriptionsv2.defer API เพื่อเลื่อนวันที่เรียกเก็บเงินสำหรับการสมัครใช้บริการ (รวมถึงการสมัครใช้บริการที่มีส่วนเสริม) ได้ เมื่อคุณเลื่อนการสมัครใช้บริการที่มีส่วนเสริม ระบบจะเลื่อนรายการทั้งหมดในการสมัครใช้บริการออกไปเป็นระยะเวลาเท่ากัน

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

สำหรับแพ็กเกจแบบชำระเงินล่วงหน้า คุณสามารถใช้ API การเลื่อนการเรียกเก็บเงินเพื่อเลื่อนเวลาหมดอายุได้

ทรัพยากรการสมัครใช้บริการสำหรับการสมัครใช้บริการที่เลื่อนเวลาออกไปจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_future,
      ...
    }
  ],
}

การสมัครใช้บริการที่หยุดชั่วคราว

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

การเกิดซ้ำของการสมัครใช้บริการ รายสัปดาห์ รายเดือน 3 เดือน 6 เดือน รายปี
ระยะเวลาการหยุดชั่วคราวที่ใช้ได้* 1 สัปดาห์
2 สัปดาห์
3 สัปดาห์
4 สัปดาห์
1 เดือน
2 เดือน
3 เดือน
1 เดือน
2 เดือน
3 เดือน
1 เดือน
2 เดือน
3 เดือน
1 เดือน
2 เดือน
3 เดือน
*อาจมีการเปลี่ยนแปลงได้ทุกเมื่อ

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

รูปที่ 5 ผู้ใช้หยุดการสมัครใช้บริการชั่วคราวแล้วกลับมาสมัครใช้บริการอีกครั้ง
รูปที่ 6 ผู้ใช้หยุดการสมัครใช้บริการชั่วคราว แล้วเข้าสู่สถานะ
การระงับบัญชี

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

เมื่อการสมัครใช้บริการของผู้ใช้ถูกหยุดชั่วคราว Play Billing Library จะไม่แสดงการสมัครใช้บริการผ่านเมธอด queryPurchasesAsync() เว้นแต่จะตั้งค่าพารามิเตอร์ includeSuspendedSubscriptions เป็น "จริง" ใน QueryPurchasesParams หากการสมัครใช้บริการกลับมาทำงานอีกครั้ง เมธอด queryPurchasesAsync() จะแสดงผลการสมัครใช้บริการอีกครั้ง

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

ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED เมื่อผู้ใช้เริ่มหยุดการสมัครใช้บริการชั่วคราว ในตอนนี้ ผู้ใช้ควรมีสิทธิ์เข้าถึงการสมัครใช้บริการจนถึงวันที่ต่ออายุครั้งถัดไป และทรัพยากรการสมัครใช้บริการจะมี autoRenewEnabled = true ค่าของช่อง subscriptionState คือ SUBSCRIPTION_STATE_ACTIVE ณ จุดนี้

ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PAUSED เมื่อการหยุดชั่วคราวมีผล เมื่อเกิดกรณีนี้ขึ้น ผู้ใช้จะเสียสิทธิ์เข้าถึงการสมัครใช้บริการ และทรัพยากรการสมัครใช้บริการจะมี autoRenewEnabled = true และช่อง subscriptionState จะตั้งค่าเป็น SUBSCRIPTION_STATE_PAUSED คุณดูวันที่คาดว่าจะต่ออายุการสมัครใช้บริการอีกครั้งได้โดยตรวจสอบออบเจ็กต์ PausedStateContext

ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_RECOVERED หากการสมัครใช้บริการกลับมาทำงานอีกครั้งโดยอัตโนมัติเมื่อสิ้นสุดระยะเวลาที่หยุดชั่วคราว หรือหากผู้ใช้เลือกที่จะกลับมาสมัครใช้บริการอีกครั้งด้วยตนเอง

ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_ON_HOLD หากการชำระเงินไม่สำเร็จขณะพยายามกลับมาสมัครใช้บริการอีกครั้งหลังจากหยุดชั่วคราว

ทั้ง 2 สถานการณ์ควรได้รับการจัดการตามที่อธิบายไว้ในการระงับบัญชี

สมัครอีกครั้ง

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

รูปที่ 7 ส่วนบัญชี > การสมัครใช้บริการของแอป Google Play Store แสดงการสมัครใช้บริการที่ยกเลิกแล้วพร้อมปุ่มสมัครอีกครั้ง

แม้ว่าปุ่มจะมีป้ายกำกับว่าสมัครอีกครั้งเสมอ แต่ฟังก์ชันการทำงานจะขึ้นอยู่กับสถานะการสมัครใช้บริการ

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

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

กู้คืนก่อนหมดอายุ

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

หากแอปซิงค์สถานะการสมัครใช้บริการกับแบ็กเอนด์ คุณควรฟังข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_RESTARTED หลังจากได้รับ RTDN นี้ แอปของคุณจะตอบสนองต่อการแจ้งเตือน บันทึกว่าตอนนี้การสมัครใช้บริการได้รับการตั้งค่าให้ต่ออายุ และหยุดแสดงข้อความการกู้คืนในแอป แหล่งข้อมูลการสมัครใช้บริการจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date
      ...
    }
  ],
}

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

สมัครอีกครั้งหลังจากหมดอายุ

หากมีการกำหนดค่าแพ็กเกจเริ่มต้นแบบต่ออายุใหม่อัตโนมัติโดยใช้ Google Play Console หรือ API เพื่ออนุญาตให้สมัครอีกครั้ง ผู้ใช้จะซื้อการสมัครใช้บริการที่หมดอายุแล้วอีกครั้งได้ใน Google Play Store

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

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

  1. เรียกใช้ purchases.subscriptionsv2.get ด้วยโทเค็นการซื้อใหม่จาก RTDN การตอบกลับสําหรับการซื้อนอกแอปประเภทนี้จะมีช่อง outOfAppPurchaseContext ซึ่งแสดงเฉพาะสําหรับการซื้อเพื่อสมัครอีกครั้งที่ยังไม่ได้ตอบรับ ช่องนี้จะแสดงข้อมูลต่อไปนี้

    • expiredExternalAccountIdentifiers: ออบเจ็กต์ ExternalAccountIdentifiers ที่มีช่อง obfuscatedAccountId และ obfuscatedProfileId ซึ่งกำหนดค่าไว้สำหรับการสมัครใช้บริการที่หมดอายุก่อนหน้านี้ หากมีการตั้งค่าไว้
    • expiredPurchaseToken: โทเค็นการซื้อของการสมัครใช้บริการที่หมดอายุล่าสุด

    ใช้ตัวระบุอย่างใดอย่างหนึ่งเหล่านี้เพื่อค้นหาและลิงก์การซื้อใหม่กับบัญชีผู้ใช้ที่ถูกต้องในแบ็กเอนด์

  2. โทรหา purchases.subscriptions.acknowledge เพื่อรับทราบการซื้อ

    • คุณสามารถส่ง obfuscatedAccountId และ obfuscatedProfileId ของผู้ใช้ได้หากกำหนดค่าไว้โดยใช้ setObfuscatedAccountId และ setObfuscatedProfileId ในระหว่างโฟลว์การเรียกเก็บเงินสำหรับการซื้อในแอป

แนวทางฝั่งเซิร์ฟเวอร์นี้ช่วยให้คุณรับทราบการซื้อภายใน 3 วันนับจากวันที่ซื้อ แม้ว่าผู้ใช้จะไม่ได้เปิดแอปก็ตาม

การอัปเกรด การดาวน์เกรด และการสมัครอีกครั้ง

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

นอกจากนี้ ทรัพยากรการสมัครใช้บริการที่แสดงผลจาก Google Play Developer API จะมีช่อง linkedPurchaseToken ที่ระบุการซื้อเดิมที่ผู้ใช้อัปเกรด ดาวน์เกรด หรือสมัครใช้บริการอีกครั้ง คุณสามารถใช้โทเค็นการซื้อในช่องนั้นเพื่อค้นหาการสมัครใช้บริการเก่าและระบุบัญชีผู้ใช้ที่มีอยู่ เพื่อให้คุณเชื่อมโยงการซื้อใหม่กับบัญชีเดียวกันได้

เมื่อผู้ใช้ลงชื่อสมัครใช้แพ็กเกจเริ่มต้นเดิมอีกครั้งจากแอปของคุณก่อนที่การสมัครใช้บริการจะหมดอายุ Google Play จะสร้างคำสั่งซื้อในราคา ฿0.00 สำหรับการซื้อใหม่ ระบบจะไม่เรียกเก็บเงินจากผู้ใช้เมื่อลงชื่อสมัครใช้ เนื่องจากผู้ใช้ได้ชำระเงินสำหรับช่วงเวลาที่เรียกเก็บเงินปัจจุบันแล้ว การเรียกเก็บเงินตามปกติจะกลับมาทำงานอีกครั้งในวันที่ต่ออายุเดิม คำสั่งซื้อราคา $0.00 จะปรากฏในการจัดการคำสั่งซื้อใน Play Console และในรายงานทางการเงิน แต่ไม่ได้หมายความว่าผู้ใช้ได้รับช่วงทดลองใช้ฟรีหรือส่วนลดโปรโมชัน

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

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

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "linkedPurchaseToken": old_purchase_token,
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

การเปลี่ยนแปลงราคา

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

เมื่อมีการเพิ่มการเปลี่ยนแปลงราคาและสำหรับการอัปเดตสถานะการเปลี่ยนแปลงราคา คุณจะได้รับ RTDN SUBSCRIPTION_PRICE_CHANGE_UPDATED คุณสามารถค้นหาปลายทาง purchases.subscriptionsv2.get เพื่อรับทรัพยากรการสมัครใช้บริการซึ่งจะมีรายละเอียดการเปลี่ยนแปลงราคาสำหรับแต่ละรายการในการสมัครใช้บริการ

เมื่อมีการเปลี่ยนแปลงราคาสำหรับสมาชิกเดิมเป็นแบบเลือกรับ คุณจะได้รับ RTDN หากผู้ใช้ดำเนินการเพื่อยืนยันหรือปฏิเสธราคาใหม่

จัดการการยืนยันของผู้ใช้เกี่ยวกับการเปลี่ยนแปลงราคาแบบเลือกรับ

เมื่อผู้ใช้ยอมรับการขึ้นราคาการสมัครใช้บริการ คุณจะได้รับข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PRICE_CHANGE_UPDATED

จัดการการต่ออายุหลังจากใช้การเปลี่ยนแปลงราคา

เมื่อมีการลดราคาหรือเมื่อการสมัครใช้บริการต่ออายุในราคาที่เพิ่มขึ้น คุณจะได้รับข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_RENEWED โปรดดำเนินการกับการแจ้งเตือนนี้เช่นเดียวกับการต่ออายุอื่นๆ

จัดการกรณีที่ผู้ใช้ไม่ยอมรับการขึ้นราคาแบบขอให้ผู้ใช้ยินยอม

หากผู้ใช้ไม่ได้ยอมรับการขึ้นราคาแบบขอให้ผู้ใช้ยินยอมก่อนที่จะต้องต่ออายุในราคาที่สูงขึ้น ระบบจะยกเลิกการสมัครใช้บริการของผู้ใช้โดยอัตโนมัติ และคุณจะได้รับข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_CANCELED จัดการเหตุการณ์นี้ตามที่อธิบายไว้ในการยกเลิก

ผู้ใช้ยังสามารถยกเลิกการสมัครใช้บริการสำหรับการขึ้นราคาแบบไม่ได้ขอให้ผู้ใช้ยินยอมได้ด้วยโดยใช้กลไกเดียวกัน

เนื่องจากกฎระเบียบใหม่ของเกาหลีใต้ (KR) ผู้ใช้ที่สมัครใช้บริการในภูมิภาค KR ต้องให้ความยินยอมต่อการปรับขึ้นราคาที่จะเกิดขึ้นหลังจากช่วงทดลองใช้ฟรีหรือช่วงแนะนำสิ้นสุดลง

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

เมื่อระยะเวลาขอความยินยอมเริ่มต้นขึ้นหรือผู้ใช้ให้ความยินยอมแล้ว คุณจะได้รับข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED

ความแตกต่างระหว่างการเพิ่มราคาและการเปลี่ยนแปลงราคา

price step-up หมายถึงราคาการสมัครใช้บริการที่เพิ่มขึ้นเนื่องจากการเปลี่ยนจากช่วงข้อเสนอหนึ่งไปยังอีกช่วงหนึ่ง เช่น การสมัครใช้บริการที่เปลี่ยนจากช่วงทดลองใช้ฟรีเป็นราคาปกติ คุณสามารถใช้ช่อง offerPhase ในทรัพยากรการสมัครใช้บริการเพื่อระบุระยะปัจจุบันของการสมัครใช้บริการได้

อย่างไรก็ตาม price change หมายถึงการอัปเดตราคาที่คุณ (นักพัฒนาแอป) เป็นผู้เริ่มสำหรับราคาแพ็กเกจเริ่มต้นของการสมัครใช้บริการ เช่น การขึ้นราคาแบบขอให้ผู้ใช้ยินยอมหรือการขึ้นราคาแบบไม่ได้ขอให้ผู้ใช้ยินยอม

จัดการวงจรของแพ็กเกจแบบชำระเงินล่วงหน้า

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

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

รูปที่ 8 สถานะวงจรและเหตุการณ์การเปลี่ยนสถานะสำหรับการซื้อการสมัครใช้บริการ

ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PURCHASED ไปยังไคลเอ็นต์ RTDN ทุกครั้งที่มีการซื้อการสมัครใช้บริการแพ็กเกจแบบชำระเงินล่วงหน้า ซึ่งรวมถึงการเติมเงินทุกครั้ง เรียกใช้เมธอด purchases.subscriptionsv2.get เพื่อตรวจสอบสถานะการสมัครใช้บริการแพ็กเกจแบบชำระเงินล่วงหน้าล่าสุด

ระบบจะออกโทเค็นการซื้อใหม่สำหรับการซื้อแบบเติมเงิน และคุณจะได้รับโทเค็นการซื้อก่อนหน้าในช่อง linkedPurchaseToken ซึ่งเป็นส่วนหนึ่งของสถานะการซื้อการสมัครใช้บริการใหม่ โทเค็นการซื้อจะใช้ได้ตั้งแต่การลงชื่อสมัครใช้การสมัครใช้บริการจนถึง 60 วันหลังจากหมดอายุ หลังจากวันที่ดังกล่าว โทเค็นการซื้อจะใช้ไม่ได้อีกต่อไปสำหรับการเรียกใช้ Google Play Developer API

ทรัพยากรการสมัครใช้บริการสำหรับการซื้อแพ็กเกจแบบชำระเงินล่วงหน้าจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  "startTime": "2022-04-22T18:39:58.270Z",
  "regionCode": "US",
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "latestOrderId": "GPA.3333-4137-0319-36762",
  "acknowledgementState": "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED",
  "lineItems": [
    {
      "productId": "prepaid_plan01",
      "expiryTime": expiry_date,
      "prepaidPlan": {
        "allowExtendAfterTime": timestamp_after_which_topups_are_allowed
      }
    }
  ]
}

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

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

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

ฟิลด์ SubscriptionPurchaseV2 สำหรับแพ็กเกจแบบชำระเงินล่วงหน้า

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

  • [ช่องใหม่] lineItems[0].prepaid_plan.allowExtendAfterTime: ระบุเวลาที่ผู้ใช้จะได้รับอนุญาตให้ซื้อการเติมเงินอีกครั้งเพื่อขยายแพ็กเกจแบบชำระเงินล่วงหน้า เนื่องจากผู้ใช้จะได้รับอนุญาตให้มีการเติมเงินที่ยังไม่ได้ใช้เพียงครั้งละ 1 รายการเท่านั้น
  • [ช่องใหม่] SubscriptionState: ระบุสถานะออบเจ็กต์การสมัครใช้บริการ สำหรับแพ็กเกจแบบชำระเงินล่วงหน้า ค่านี้จะเป็น ACTIVE, PENDING หรือ CANCELED เสมอ
  • lineItems[0].expiryTime: ช่องนี้จะแสดงสำหรับแพ็กเกจแบบชำระเงินล่วงหน้าเสมอ
  • paused_state_context: ช่องนี้จะไม่แสดง เนื่องจากแพ็กเกจแบบชำระเงินล่วงหน้าไม่สามารถหยุดชั่วคราวได้
  • lineItems[0].auto_renewing_plan: ไม่มีสำหรับแพ็กเกจแบบชำระเงินล่วงหน้า
  • canceled_state_context: ไม่มีสำหรับแพ็กเกจแบบชำระเงินล่วงหน้า เนื่องจากช่องนี้ใช้กับผู้ใช้ที่ยกเลิกการสมัครใช้บริการอยู่เท่านั้น
  • lineItems[0].productId: ช่องนี้จะแทนที่ subscriptionId จากเวอร์ชันก่อนหน้า