คุณอาจต้องดำเนินการจัดการกับการสมัครใช้บริการหรือการซื้อครั้งเดียวซึ่งเป็นส่วนหนึ่งของธุรกิจประจำวัน ตัวอย่างเช่น ฝ่ายบริการลูกค้าอาจต้องคืนเงินเต็มจำนวนหรือการคืนเงินบางส่วนให้แก่ผู้ใช้ หรือคุณอาจต้องเพิกถอนสิทธิ์ในบางกรณี คุณสามารถจัดการคำสั่งซื้อจาก 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 รายการ ดูเลื่อนการเรียกเก็บเงินสำหรับสมาชิกในเกี่ยวกับการสมัครใช้บริการเพื่อดูวิธีจัดการเหตุการณ์เหล่านี้
ตัวอย่าง
บริการสตรีมมิง FitnessGoals ต้องการแสดงโปรโมชันเพื่อส่งเสริมการออกกำลังกายเป็นประจำในเดือนกุมภาพันธ์
จึงตัดสินใจที่จะมอบบริการเพิ่มอีก 1 เดือนให้แก่สมาชิกที่ออกกำลังกายด้วย FitnessGoals อย่างน้อย 10 ครั้งในเดือนกุมภาพันธ์
โดยจะติดตามผลลัพธ์ของชาเลนจ์ และในวันที่ 1 มีนาคม จะเรียกใช้เมธอด subscriptionsv2.defer สำหรับการซื้อการสมัครใช้บริการที่ใช้งานอยู่ทั้งหมดของผู้ใช้ที่ทำชาเลนจ์สำเร็จในเดือนกุมภาพันธ์
ผู้ใช้เหล่านี้จะได้รับสิทธิประโยชน์เป็นวิดีโอการออกกำลังกายปกติเพิ่มอีก 1 เดือนเต็มโดยไม่มีค่าใช้จ่าย และผู้ใช้จะบอกต่อเพื่อนๆ ทุกคนว่า FitnessGoals ช่วยให้พวกเขามีสุขภาพดีได้อย่างไร
คืนเงินและเพิกถอนสิทธิ์
มีหลายสถานการณ์ที่คุณอาจต้องการคืนเงินหรือเพิกถอนสิทธิ์เข้าถึงการสมัครใช้บริการหรือการซื้อครั้งเดียว
คืนเงินเต็มจำนวนให้แก่คำสั่งซื้อตามรหัสคำสั่งซื้อ
คุณสามารถใช้ orders.refund API เพื่อคืนเงินเต็มจำนวนสำหรับคำสั่งซื้อใดก็ได้ภายใน 3 ปีนับจากวันที่ซื้อ
เมธอด orders.refund จะได้รับพารามิเตอร์การเพิกถอนที่ระบุว่าควรเพิกถอนสิทธิ์เข้าถึงหรือไม่ นอกเหนือจากการคืนเงิน
หากคุณทำการเพิกถอนด้วยการเรียกใช้การคืนเงินสำหรับการซื้อการสมัครใช้บริการ การสมัครใช้บริการจะสิ้นสุดลงทันทีและจะทริกเกอร์ทั้งSUBSCRIPTION_REVOKEDการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปและVoidedPurchaseNotification (บันทึกไว้ใน Voided Purchases API) อ่านคู่มือการจัดการวงจรการสมัครใช้บริการในส่วนการเพิกถอนเพื่อดูวิธีจัดการเหตุการณ์เหล่านี้
ตัวอย่าง
เพื่อเฉลิมฉลองการเริ่มต้นฟุตบอลโลกครั้งใหม่ แอปอีสปอร์ต Football-Not-Soccer ตัดสินใจจับสลากแจกเสื้อเสมือนจริงฟรีสำหรับผู้ใช้ทุกคนที่ซื้อชุดทีมใหม่ในช่วง 24 ชั่วโมงแรก
Football-Not-Soccer ใช้
orders.refundAPI โดยไม่ส่งพารามิเตอร์เพิกถอนเพื่อคืนเงินค่าเสื้อให้แก่ผู้ชนะ
เพิกถอนและคืนเงินสำหรับการสมัครใช้บริการตามโทเค็นการซื้อ
ในบางกรณี คุณอาจต้องเพิกถอนสิทธิ์เข้าถึงการสมัครใช้บริการของผู้ใช้และคืนเงิน 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": {} เป็นประเภทการคืนเงิน
ตัวอย่าง
มาเรียมีการสมัครใช้บริการแพ็กเกจรายเดือนแบบสตรีมมิงของ SuperMovies เป็นเวลา 30 วันซึ่งต่ออายุใหม่อัตโนมัติ Maria พบปัญหาทางเทคนิคบางอย่างที่ทำให้เข้าถึงเนื้อหาไม่ได้ ลูกค้าติดต่อฝ่ายบริการลูกค้าในวันที่ 3 ของรอบการเรียกเก็บเงิน โดยระบุว่าไม่เคยได้รับสิทธิ์เข้าถึงการสมัครใช้บริการ
ฝ่ายบริการลูกค้าค้นหารายละเอียดการซื้อการสมัครใช้บริการของมาเรียในระบบและเรียกใช้
purchases.subscriptionsv2.revokeเพื่อขอการคืนเงินเต็มจำนวนฝ่ายบริการลูกค้าแจ้ง Maria ว่าเธอควรได้รับเงินคืน 100% ของราคาการสมัครใช้บริการ และเธอไม่ได้สมัครใช้บริการแพ็กเกจดังกล่าวอีกต่อไป
การคืนเงินตามสัดส่วน
หากต้องการสิ้นสุดการสมัครใช้บริการและคืนเงินบางส่วนสำหรับเวลาที่เหลืออยู่ของสิทธิ์ ให้คืนเงินตามสัดส่วน ใช้ฟังก์ชัน purchases.subscriptionsv2.revoke และตั้งค่า "proratedRefund": {} เป็นประเภทการคืนเงิน
ระบบรองรับการคืนเงินตามสัดส่วนทั้งสำหรับการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติและแพ็กเกจแบบชำระเงินล่วงหน้าที่มีระยะเวลาอย่างน้อย 1 สัปดาห์
ตัวอย่าง
มาเรียมีการสมัครใช้บริการแพ็กเกจรายเดือนแบบสตรีมมิงของ SuperMovies เป็นเวลา 30 วันซึ่งต่ออายุใหม่อัตโนมัติ เธอใช้บริการนี้อย่างมีความสุขมาได้สักพักแล้ว Maria ติดต่อฝ่ายบริการลูกค้าในวันที่ 15 ของรอบการเรียกเก็บเงิน โดยระบุว่าเธอกำลังจะย้ายไปต่างประเทศและจะใช้บริการไม่ได้อีกต่อไปตั้งแต่วันถัดไป
ฝ่ายบริการลูกค้าค้นหารายละเอียดการซื้อการสมัครใช้บริการของมาเรียในระบบและเรียกใช้การเรียกไปยัง
purchases.subscriptionsv2.revokeเพื่อขอเงินคืนตามสัดส่วนฝ่ายบริการลูกค้าแจ้ง Maria ว่าเธอควรได้รับเงินคืนประมาณ 50% ของราคาการสมัครใช้บริการ และสิทธิ์เข้าถึงบริการจะสิ้นสุดลงทันที