bizz84/SwiftyStoreKit

Documentation on how to handle deferred purchases correctly

Open

#358 opened on Mar 31, 2018

View on GitHub
 (0 comments) (7 reactions) (0 assignees)Swift (6,419 stars) (792 forks)batch import
area: purchase flowsdifficulty: advancedhelp wantedtype: enhancement

Description

Platform

  • iOS
  • macOS
  • tvOS

In app purchase type

  • Consumable
  • Non-consumable
  • Auto-Renewable Subscription
  • Non-Renewing Subscription

Environment

  • Sandbox
  • Production

Version

0.13.1

Related issues

Report

Issue summary

It would be helpful to have guidelines on how to handle purchases that are returned in a deferred state. This can happen when parental permission is required to make an in-app purchase. From what I can tell from the code, the CompleteTransactionsController calls the callback on the completeTransactions which is only instantiated once on app launch (per the recommendations). Since that callback isn't made in the ViewController that makes the purchase, I don't know exactly when/how to update the UI to show that the purchase is waiting.

The reason this is so difficult is that there's no way to test this at all. So, having some sample code would be very helpful!

What did you expect to happen

The UI should be updated to show that the transaction is waiting for permission

What happened instead

The View Controller that is making the purchase never gets called back when the purchase is returned in a deferred state.

Contributor guide

Tech stack
swiftios
Domain
mobiledocumentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
SwiftSwiftyStoreKitStoreKit deferred purchases
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75
Research direction
Research the exact flow of deferred purchases in StoreKit and how SwiftyStoreKit's CompleteTransactionsController handles them. Look at the existing documentation structure in the repo. Write a clear guide with sample code for handling the deferred state in a ViewController that initiates the purchase. Include notes on testing limitations.