pushinbr/pam-native-subscriptions

StoreKit 2 and Google Play Billing subscriptions for PAM Native.

v0.1.0 2026-08-01 05:38 UTC

Requires

• php: ^8.4
• pushinbr/pam-native: ^0.6.1

BUSL-1.1

Published on Packagist.org on 2026-08-01 06:05 UTC

README

StoreKit 2 and Google Play Billing subscriptions with products/offers, purchases, pending states, restore, signed JWS or Play purchase tokens, and explicit Play acknowledgement after server verification.

Never grant durable entitlement from the device callback alone. Send verification to your backend, validate it with the App Store Server API or Google Play Developer API, persist the entitlement, then acknowledge Google Play purchases.

Install

composer require pushinbr/pam-native-subscriptions
pam mobile prepare

Configure matching product identifiers in App Store Connect and Google Play Console before querying the catalog.

Load and purchase

use Pam\Native\Subscriptions\Subscriptions;

$subscriptions = new Subscriptions();
$subscriptions->products(['pro.monthly'], function (array $products) use ($subscriptions): void {
    $product = $products[0] ?? null;
    if ($product === null) {
        return;
    }

    $subscriptions->purchase(
        $product->identifier,
        fn ($transaction) => sendToYourBackend($transaction->verification),
        $product->offerToken,
    );
});

The purchase result distinguishes completed, pending, cancelled, and failed states through SubscriptionPurchaseState. Use restore() during account recovery and after sign-in on a new device.