จัดการการสมัครใช้บริการและการซื้อครั้งเดียว

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

ยกเลิกการสมัครใช้บริการ

ผู้ใช้หรือนักพัฒนาแอปสามารถเริ่มการยกเลิกการสมัครใช้บริการได้

การยกเลิกที่เริ่มโดยผู้ใช้

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

วิธีที่ง่ายที่สุดในการอนุญาตให้ผู้ใช้ยกเลิกด้วยตนเองคือการระบุ Deep Link ในแอปไปยัง Play Store ซึ่งผู้ใช้จะดูและจัดการการสมัครใช้บริการได้

การยกเลิกที่นักพัฒนาแอปเป็นผู้เริ่ม

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

วิธีนี้ช่วยให้คุณระบุประเภทการยกเลิกต่อไปนี้ในพารามิเตอร์เนื้อหาคำขอ cancellationType ได้

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

  • DEVELOPER_REQUESTED_STOP_PAYMENTS: ยกเลิกการสมัครใช้บริการและป้องกันไม่ให้มีการชำระเงินเพิ่มเติม ผู้ใช้จะกู้คืนหรือสมัครใช้บริการอีกครั้งจาก Play Store ไม่ได้ แต่คุณสามารถเปิดให้ผู้ใช้สมัครใช้บริการอีกครั้งภายในแอปของคุณได้

อนุญาตให้ผู้ใช้กู้คืนการสมัครใช้บริการที่ยังไม่หมดอายุ

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

หากต้องการระบุว่าผู้ใช้สามารถกู้คืนการยกเลิกได้ ให้ส่งคำขอ POST ไปยัง purchases.subscriptions.cancel API และตั้งค่าพารามิเตอร์คำขอ cancellationType เป็นค่า USER_REQUESTED_STOP_RENEWALS

ตัวอย่าง

  • โทเค็นการซื้อของการสมัครใช้บริการ 1a2b3c4d5e6f7g8h9i0j
  • ชื่อแพ็กเกจของแอปพลิเคชัน com.your.app
  • รหัสการสมัครใช้บริการ your-subscription-product

คำขอ HTTP POST:

https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptions/your-subscription-product/tokens/1a2b3c4d5e6f7g8h9i0j:cancel

เนื้อหาคำขอ:

{
  "cancellationType": "USER_REQUESTED_STOP_RENEWALS"
}

อนุญาตให้ผู้ใช้สมัครใช้บริการที่หมดอายุแล้วอีกครั้ง

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

อนุญาตให้ผู้ใช้สมัครใช้บริการอีกครั้งในแอปพลิเคชันของคุณเท่านั้น

หากคุณตั้งค่าพารามิเตอร์ cancellationType เป็น DEVELOPER_REQUESTED_STOP_PAYMENTS หรือไม่ได้ตั้งค่าพารามิเตอร์ cancellationType ผู้ใช้จะกู้คืนการสมัครใช้บริการจากศูนย์การสมัครใช้บริการของ Play ไม่ได้ อย่างไรก็ตาม ผู้ใช้สามารถลงชื่อสมัครใช้บริการอีกครั้งผ่านแอปของคุณได้หากต้องการ

การดำเนินการนี้จะทริกเกอร์การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป SUBSCRIPTION_CANCELED รายการ จัดการการยกเลิกเหล่านี้ตามที่อธิบายไว้ในการยกเลิก

เลื่อนการเรียกเก็บเงิน

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

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

ตัวอย่างวิธีใช้การเรียกเก็บเงินรอการตัดบัญชีมีดังนี้

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

คุณสามารถเลื่อนการเรียกเก็บเงินได้ตั้งแต่ 1 วันไปจนถึง 1 ปีต่อการเรียก API หากต้องการเลื่อนการสิ้นสุดสิทธิ์ออกไปอีก ให้เรียกใช้ API อีกครั้งก่อนถึงวันที่หมดอายุใหม่

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

ตัวอย่าง

  1. บริการสตรีมมิง FitnessGoals ต้องการแสดงโปรโมชันเพื่อส่งเสริมการออกกำลังกายเป็นประจำในเดือนกุมภาพันธ์

  2. จึงตัดสินใจที่จะมอบบริการเพิ่มอีก 1 เดือนให้แก่สมาชิกที่ออกกำลังกายด้วย FitnessGoals อย่างน้อย 10 ครั้งในเดือนกุมภาพันธ์

  3. โดยจะติดตามผลลัพธ์ของชาเลนจ์ และในวันที่ 1 มีนาคม จะเรียกใช้เมธอด subscriptionsv2.defer สำหรับการซื้อการสมัครใช้บริการที่ใช้งานอยู่ทั้งหมดของผู้ใช้ที่ทำชาเลนจ์สำเร็จในเดือนกุมภาพันธ์

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

คืนเงินและเพิกถอนสิทธิ์

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

คืนเงินเต็มจำนวนให้แก่คำสั่งซื้อตามรหัสคำสั่งซื้อ

คุณสามารถใช้ orders.refund API เพื่อคืนเงินเต็มจำนวนสำหรับคำสั่งซื้อใดก็ได้ภายใน 3 ปีนับจากวันที่ซื้อ เมธอด orders.refund จะได้รับพารามิเตอร์การเพิกถอนที่ระบุว่าควรเพิกถอนสิทธิ์เข้าถึงหรือไม่ นอกเหนือจากการคืนเงิน

หากคุณทำการเพิกถอนด้วยการเรียกใช้การคืนเงินสำหรับการซื้อการสมัครใช้บริการ การสมัครใช้บริการจะสิ้นสุดลงทันทีและจะทริกเกอร์ทั้งSUBSCRIPTION_REVOKEDการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปและVoidedPurchaseNotification (บันทึกไว้ใน Voided Purchases API) อ่านคู่มือการจัดการวงจรการสมัครใช้บริการในส่วนการเพิกถอนเพื่อดูวิธีจัดการเหตุการณ์เหล่านี้

ตัวอย่าง

  1. เพื่อเฉลิมฉลองการเริ่มต้นฟุตบอลโลกครั้งใหม่ แอปอีสปอร์ต Football-Not-Soccer ตัดสินใจจับสลากแจกเสื้อเสมือนจริงฟรีสำหรับผู้ใช้ทุกคนที่ซื้อชุดทีมใหม่ในช่วง 24 ชั่วโมงแรก

  2. Football-Not-Soccer ใช้ orders.refund API โดยไม่ส่งพารามิเตอร์เพิกถอนเพื่อคืนเงินค่าเสื้อให้แก่ผู้ชนะ

เพิกถอนและคืนเงินสำหรับการสมัครใช้บริการตามโทเค็นการซื้อ

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

การดำเนินการนี้จะทริกเกอร์ทั้งการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป SUBSCRIPTION_REVOKED และ VoidedPurchaseNotification รวมถึงบันทึกไว้ใน Voided Purchases API แอปของคุณควรจัดการการยกเลิกเหล่านี้ตามที่อธิบายไว้ในการเพิกถอน

ตัวอย่าง

  • ซื้อด้วยโทเค็นการซื้อ 1a2b3c4d5e6f7g8h9i0j
  • แอปพลิเคชันที่มีชื่อแพ็กเกจ com.your.app
  • เจตนาในการคืนเงินตามสัดส่วน

คำขอ HTTP POST:

https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke

เนื้อหาคำขอ:

{
  "revocationContext": {
    "proratedRefund": {}
  }
}

คืนเงินเต็มจำนวน

หากต้องการสิ้นสุดการสมัครใช้บริการและคืนเงินเต็มจำนวนของช่วงเวลาที่เรียกเก็บเงินปัจจุบัน ให้ออกการคืนเงินเต็มจำนวน ใช้ฟังก์ชัน purchases.subscriptionsv2.revoke และตั้งค่า "fullRefund": {} เป็นประเภทการคืนเงิน

ตัวอย่าง

  1. มาเรียมีการสมัครใช้บริการแพ็กเกจรายเดือนแบบสตรีมมิงของ SuperMovies เป็นเวลา 30 วันซึ่งต่ออายุใหม่อัตโนมัติ Maria พบปัญหาทางเทคนิคบางอย่างที่ทำให้เข้าถึงเนื้อหาไม่ได้ ลูกค้าติดต่อฝ่ายบริการลูกค้าในวันที่ 3 ของรอบการเรียกเก็บเงิน โดยระบุว่าไม่เคยได้รับสิทธิ์เข้าถึงการสมัครใช้บริการ

  2. ฝ่ายบริการลูกค้าค้นหารายละเอียดการซื้อการสมัครใช้บริการของมาเรียในระบบและเรียกใช้ purchases.subscriptionsv2.revoke เพื่อขอการคืนเงินเต็มจำนวน

  3. ฝ่ายบริการลูกค้าแจ้ง Maria ว่าเธอควรได้รับเงินคืน 100% ของราคาการสมัครใช้บริการ และเธอไม่ได้สมัครใช้บริการแพ็กเกจดังกล่าวอีกต่อไป

การคืนเงินตามสัดส่วน

หากต้องการสิ้นสุดการสมัครใช้บริการและคืนเงินบางส่วนสำหรับเวลาที่เหลืออยู่ของสิทธิ์ ให้คืนเงินตามสัดส่วน ใช้ฟังก์ชัน purchases.subscriptionsv2.revoke และตั้งค่า "proratedRefund": {} เป็นประเภทการคืนเงิน

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

ตัวอย่าง

  1. มาเรียมีการสมัครใช้บริการแพ็กเกจรายเดือนแบบสตรีมมิงของ SuperMovies เป็นเวลา 30 วันซึ่งต่ออายุใหม่อัตโนมัติ เธอใช้บริการนี้อย่างมีความสุขมาได้สักพักแล้ว Maria ติดต่อฝ่ายบริการลูกค้าในวันที่ 15 ของรอบการเรียกเก็บเงิน โดยระบุว่าเธอกำลังจะย้ายไปต่างประเทศและจะใช้บริการไม่ได้อีกต่อไปตั้งแต่วันถัดไป

  2. ฝ่ายบริการลูกค้าค้นหารายละเอียดการซื้อการสมัครใช้บริการของมาเรียในระบบและเรียกใช้การเรียกไปยัง purchases.subscriptionsv2.revoke เพื่อขอเงินคืนตามสัดส่วน

  3. ฝ่ายบริการลูกค้าแจ้ง Maria ว่าเธอควรได้รับเงินคืนประมาณ 50% ของราคาการสมัครใช้บริการ และสิทธิ์เข้าถึงบริการจะสิ้นสุดลงทันที