Pengembalian dana Family Sharing membalikkan satu pembayaran tetapi bisa membuat lima orang lain tetap memakai aplikasi Anda, dan hanya server Anda yang dapat memutus akses mereka

Satu pembelian dalam grup Family Sharing bisa memberikan aplikasi Anda kepada enam orang. Orang yang membayar adalah salah satunya. Lima lainnya tidak pernah membuka dompet mereka, dan Apple tetap mengharapkan aplikasi Anda berfungsi untuk mereka semua. Itulah kesepakatan yang Anda pilih begitu Anda mengaktifkan Family Sharing untuk pembelian dalam aplikasi. Itu juga sebabnya pengembalian dana Family Sharing adalah makhluk yang berbeda dari yang biasa. Ketika pembeli mendapatkan uangnya kembali, penjualan dibalik untuk satu akun, tetapi akses yang Anda berikan kepada sebanyak lima orang lain tidak mati dengan sendirinya. Server Anda yang harus melakukannya, dan jika ditulis untuk hanya mengawasi pembeli, ia tidak akan melakukannya.

Berikut gambaran lengkapnya dalam satu tempat. Ini menjelaskan bagaimana Apple menandai pembelian bersama, satu kolom yang membedakan pembeli dari keluarga, tepatnya kapan Apple mengirimi Anda REVOKE dan cara membacanya, detail tenang yang memisahkan pengembalian dana dari seseorang yang sekadar meninggalkan keluarga, dan berapa biaya sebenarnya pengembalian dana bersama setelah Anda menghitung komputasi yang sudah Anda belanjakan untuk orang-orang yang tidak pernah membayar Anda.

Apa yang diberikan Family Sharing, dan kepada berapa banyak orang

Aktifkan Family Sharing untuk sebuah produk dan Anda mengubah siapa pelanggan yang membayar Anda. Grup keluarga di Apple bisa menampung hingga enam orang, satu penyelenggara dan hingga lima anggota. Ketika siapa pun dalam grup membeli produk yang bisa dibagikan ke keluarga, semua orang dalam grup mendapatkan aksesnya. Mereka tidak membayar. Mereka tidak muncul dalam pendapatan Anda. Mereka hanya muncul di aplikasi Anda dengan hak yang sah, karena Apple menerbitkan untuk masing-masing dari mereka sebuah transaksi yang menunjuk ke pembelian yang sama.

Hanya dua jenis produk yang bisa dibagikan, dan konsumsi bukan salah satunya

Family Sharing mencakup tepat dua jenis pembelian dalam aplikasi: non-konsumsi dan langganan perpanjangan otomatis. Produk konsumsi, produk koin-dan-kredit, tidak pernah dibagikan, itulah sebabnya anggota keluarga tidak pernah memicu CONSUMPTION_REQUEST atau muncul dalam pelaporan konsumsi Anda. Jika aplikasi Anda hanya menjual produk konsumsi, pengembalian dana Family Sharing bukan masalah Anda. Jika Anda menjual buka kunci seumur hidup atau paket berulang, itu masalah Anda.

Kolom yang membedakan pembeli dari penerima manfaat

Setiap transaksi yang diterbitkan Apple membawa inAppOwnershipType. Ia memiliki dua nilai. PURCHASED berarti akun ini membayar produk tersebut dan bisa mengelolanya, termasuk membatalkannya atau meminta pengembalian dana. FAMILY_SHARED berarti akun ini adalah anggota keluarga yang memiliki akses melalui pembelian orang lain. Keduanya memberi hak kepada orang tersebut untuk memakai produk Anda. Hanya satu dari mereka yang membayar. Kolom ini ada pada transaksi StoreKit, tanda terima, dan App Store Server API, sehingga Anda bisa membacanya di mana pun Anda sudah memeriksa hak.

Bagaimana pengembalian dana Family Sharing sampai ke server Anda

Pengembalian dana atas pembelian bersama dimulai dengan cara yang sama seperti pengembalian dana Apple mana pun. Pembeli, satu-satunya orang yang bisa, meminta uangnya kembali kepada Apple. Apple memutuskan. Jika Apple mengabulkannya, pembelian pembeli dibalik dan Apple mengirim server Anda sebuah REVOKE App Store Server Notification. Baik V1 maupun V2 notifikasi tersebut membawanya. REVOKE adalah satu sinyal Anda bahwa hak di baliknya, dan setiap salinan berbagi keluarga darinya, kini batal.

Jangan cabut satu transaksi, baca ulang seluruh riwayatnya

Panduan Apple tentang REVOKE tegas: jangan memperlakukannya sebagai satu sakelar tunggal. Ketika Anda menerimanya, telusuri seluruh riwayat transaksi pelanggan dan bangun ulang hak mereka dari awal, karena seseorang bisa memegang lebih dari satu transaksi yang memberikan produk yang sama atau berbeda. Cabut hanya transaksi yang disebutkan dalam notifikasi dan Anda bisa saja meninggalkan anggota keluarga yang sudah dikembalikan dananya dengan akses aktif, atau memutus seseorang yang masih memiliki hak kedua yang sah. Bangun kembali gambaran lengkap setiap kali.

Satu detail yang memisahkan pengembalian dana dari perpecahan keluarga

Inilah jebakan yang menghabiskan satu sore debugging bagi tim. Sebuah REVOKE bisa berarti dua hal yang sangat berbeda untuk transaksi FAMILY_SHARED, dan cara Anda membedakannya adalah sebuah kolom yang terkadang sekadar tidak ada. Ketika pembeli mendapatkan pengembalian dana, transaksi FAMILY_SHARED datang dengan revocationDate. Ketika anggota keluarga sekadar meninggalkan grup, jenis REVOKE yang sama tiba tanpa revocationDate sama sekali. Insinyur perdagangan Apple telah mengatakannya secara langsung di forum pengembang. Bagaimanapun Anda mencabut aksesnya, tetapi hanya yang bertanggal yang merupakan pengembalian dana, dan hanya pengembalian dana itulah yang juga membalik sebuah pembayaran.

Berapa biaya sebenarnya pengembalian dana bersama bagi Anda

Telusuri uangnya, karena di sinilah Family Sharing diam-diam mengubah hitungannya. Pengembalian dana biasa membalik satu penjualan. Apple mengembalikan harga kepada pembeli dan menyerahkan kembali komisinya, jadi sisi toko hampir impas. Yang tidak pernah kembali adalah apa yang sudah Anda belanjakan untuk mengirimkan produk itu. Dengan Family Sharing, Anda tidak membelanjakannya sekali. Anda membelanjakannya untuk sebanyak enam orang. Pembeli dan hingga lima anggota keluarga masing-masing menjalankan komputasi Anda, memanggil API Anda, mengisi penyimpanan Anda, dan menarik pembayaran apa pun yang Anda danai, semuanya atas dasar satu pembayaran.

Sekarang pembeli mengembalikan dananya. Satu pembayaran itu dibalik. Akses setiap anggota keluarga seharusnya berakhir pada saat yang sama, karena hal yang membenarkan melayani mereka, satu pembelian berbayar, sudah tiada. Jika server Anda hanya mencabut transaksi PURCHASED dan membiarkan transaksi FAMILY_SHARED tetap aktif, hingga lima orang tetap menikmati fitur berbayar Anda secara gratis, dan Anda terus membayar untuk melayani mereka, tanpa ada yang tersisa dalam sistem untuk ditagih. Itu bukan kesalahan pembulatan. Itu lima kali biaya pengiriman dari penjualan yang baru saja Anda kembalikan.

Langganan membuat kebocorannya berulang

Untuk produk non-konsumsi, anggota keluarga yang tidak dicabut adalah kerugian satu kali yang berjalan sampai Anda menyadarinya. Untuk langganan perpanjangan otomatis, keadaannya lebih buruk, karena haknya sudah berulang. Pengembalian dana atas pesanan langganan seharusnya mengakhiri berbagi untuk seluruh grup, tetapi anggota keluarga yang dibiarkan aktif tetap memegang tingkat berbayar setiap periode penagihan yang gagal Anda tutup. Perbaikannya sama, bangun kembali hak dari seluruh riwayat pada setiap REVOKE, tetapi biaya melewatkannya bertumpuk.

Melakukannya dengan benar, dan mengujinya sebelum pengembalian dana nyata melakukannya

Tidak ada yang eksotis untuk dibangun di sini. Seluruh pekerjaannya adalah mengaitkan akses pada hak, bukan pada pembeli, dan membangun kembali akses itu pada setiap REVOKE.

• Simpan akses berdasarkan transaksi dan inAppOwnershipType-nya, bukan berdasarkan satu akun pembeli, sehingga transaksi FAMILY_SHARED memberikan akses sendiri dan bisa dicabut sendiri.
• Pada notifikasi REVOKE apa pun, baca ulang seluruh riwayat transaksi pelanggan dan hitung ulang hak, alih-alih mematikan satu transaksi yang disebutkan.
• Perlakukan transaksi FAMILY_SHARED dengan revocationDate sebagai pengembalian dana dan akhiri akses anggota tersebut. Perlakukan yang tanpa revocationDate sebagai kepergian keluarga dan akhiri juga.
• Jangan terburu-buru menyajikan pembelian bersama yang baru. Apple menahannya sekitar satu jam agar pembeli bisa membatalkan, jadi hormati transaksi yang benar-benar diterbitkan Apple alih-alih memberikan akses saat ketukan beli.
• Latih dulu. Alat Testing Family Sharing dari Apple memungkinkan Anda menyimulasikan transaksi bersama, dan pengembalian dana sandbox memicu REVOKE yang sama yang akan diterima server produksi Anda.

Lakukan itu dan pengembalian dana Family Sharing menjadi bukan peristiwa apa-apa. Pembeli mendapatkan uangnya, seluruh grup kehilangan akses dalam ketukan yang sama, dan Anda berhenti membayar untuk melayani orang-orang yang tidak pernah membayar Anda.