composer require developernauts/nativephp-inapp-purchases

php artisan native:plugin:register developernauts/nativephp-inapp-purchases

php artisan vendor:publish --provider="Developernauts\NativephpInappPurchases\NativephpInappPurchasesServiceProvider" --tag=config

php artisan native:run          # or: php artisan native:build

use Developernauts\NativephpInappPurchases\Facades\InApp;
 
// Fetch a single product (convenience wrapper around products())
$result = InApp::product('com.app.premium_monthly');
if ($result['ok']) {
    $product = $result['product'];  // single product array
    echo $product['price_formatted'];
}
 
// Fetch multiple products at once
$result = InApp::products(['com.app.premium_monthly', 'com.app.premium_yearly']);
if ($result['ok']) {
    foreach ($result['products'] as $product) {
        echo $product['title'] . ': ' . $product['price_formatted'];
    }
}
 
// Initiate a purchase
$result = InApp::purchase('com.app.premium_monthly');
 
// Restore previous purchases
$restored = InApp::restore();
 
// Check entitlement status
$entitlement = InApp::entitlement();
if ($entitlement['is_premium']) {
    // Device reports an active entitlement. For server-authoritative access,
    // verify the transaction proof (jws / purchaseToken) on your backend —
    // see "Verifying Purchases" below.
}

<?php
 
namespace App\Livewire;
 
use Developernauts\NativephpInappPurchases\Facades\InApp;
use Livewire\Component;
 
class Paywall extends Component
{
    public array $products = [];
    public array $entitlements = [];
    public bool $isPremium = false;
    public string $message = '';
 
    public function mount(): void
    {
        $this->loadProducts();
        $this->checkEntitlement();
    }
 
    public function loadProducts(): void
    {
        $result = InApp::products(['com.app.premium_monthly', 'com.app.premium_yearly']);
 
        if ($result['ok']) {
            $this->products = $result['products'];
        }
    }
 
    public function purchaseProduct(string $productId): void
    {
        $result = InApp::purchase($productId);
 
        if ($result['ok']) {
            $this->message = 'Purchase successful!';
            $this->checkEntitlement();
        } else {
            $this->message = $result['message'] ?? $result['error'] ?? 'Purchase failed';
        }
    }
 
    public function restorePurchases(): void
    {
        $result = InApp::restore();
 
        if ($result['ok']) {
            $this->message = $result['message'];
            $this->checkEntitlement();
        } else {
            $this->message = $result['message'] ?? 'Restore failed';
        }
    }
 
    public function checkEntitlement(): void
    {
        $result = InApp::entitlement();
 
        if ($result['ok']) {
            $this->isPremium = $result['is_premium'];
            $this->entitlements = $result['entitlements'];
        }
    }
 
    public function render()
    {
        return view('livewire.paywall');
    }
}

{{-- resources/views/livewire/paywall.blade.php --}}
<div>
    @if ($isPremium)
        <p>You have an active subscription.</p>
    @else
        @foreach ($products as $product)
            <div>
                <h3>{{ $product['title'] }}</h3>
                <p>{{ $product['description'] }}</p>
                <p>{{ $product['price_formatted'] }}</p>
                @if (!empty($product['introductory_offer']))
                    <p>
                        Start with {{ $product['introductory_offer']['price_formatted'] }}
                        for {{ $product['introductory_offer']['billing_cycle_count'] }}
                        {{ $product['introductory_offer']['period']['unit'] }}(s)
                    </p>
                @endif
                <button wire:click="purchaseProduct('{{ $product['id'] }}')">Subscribe</button>
            </div>
        @endforeach
 
        <button wire:click="restorePurchases">Restore Purchases</button>
    @endif
 
    @if ($message)
        <p>{{ $message }}</p>
    @endif
</div>

import { products, purchase, restore, entitlement, ping } from '../../vendor/developernauts/nativephp-inapp-purchases/resources/js/index.js';

<script setup>
import { ref, onMounted } from 'vue';
import { products, purchase, restore, entitlement } from '../../vendor/developernauts/nativephp-inapp-purchases/resources/js/index.js';
 
const productList = ref([]);
const isPremium = ref(false);
const message = ref('');
 
onMounted(async () => {
    await loadProducts();
    await checkEntitlement();
});
 
async function loadProducts() {
    try {
        const result = await products(['com.app.premium_monthly', 'com.app.premium_yearly']);
        productList.value = result.products;
    } catch (err) {
        message.value = err.message;
    }
}
 
async function buyProduct(productId) {
    try {
        const result = await purchase(productId);
        message.value = result.message;
        await checkEntitlement();
    } catch (err) {
        message.value = err.data?.message ?? err.message;
    }
}
 
async function restorePurchases() {
    try {
        const result = await restore();
        message.value = result.message;
        await checkEntitlement();
    } catch (err) {
        message.value = err.data?.message ?? err.message;
    }
}
 
async function checkEntitlement() {
    try {
        const result = await entitlement();
        isPremium.value = result.is_premium;
    } catch (err) {
        console.error('Entitlement check failed:', err);
    }
}
</script>
 
<template>
    <div v-if="isPremium">
        <p>You have an active subscription.</p>
    </div>
    <div v-else>
        <div v-for="product in productList" :key="product.id">
            <h3>{{ product.title }}</h3>
            <p>{{ product.description }}</p>
            <p>{{ product.price_formatted }}</p>
            <p v-if="product.introductory_offer">
                Start with {{ product.introductory_offer.price_formatted }}
                for {{ product.introductory_offer.billing_cycle_count }}
                {{ product.introductory_offer.period.unit }}(s)
            </p>
            <button @click="buyProduct(product.id)">Subscribe</button>
        </div>
        <button @click="restorePurchases">Restore Purchases</button>
    </div>
    <p v-if="message">{{ message }}</p>
</template>

import { useState, useEffect } from 'react';
import { products, purchase, restore, entitlement } from '../../vendor/developernauts/nativephp-inapp-purchases/resources/js/index.js';
 
export default function Paywall() {
    const [productList, setProductList] = useState([]);
    const [isPremium, setIsPremium] = useState(false);
    const [message, setMessage] = useState('');
 
    useEffect(() => {
        loadProducts();
        checkEntitlement();
    }, []);
 
    async function loadProducts() {
        try {
            const result = await products(['com.app.premium_monthly', 'com.app.premium_yearly']);
            setProductList(result.products);
        } catch (err) {
            setMessage(err.message);
        }
    }
 
    async function buyProduct(productId) {
        try {
            const result = await purchase(productId);
            setMessage(result.message);
            await checkEntitlement();
        } catch (err) {
            setMessage(err.data?.message ?? err.message);
        }
    }
 
    async function restorePurchases() {
        try {
            const result = await restore();
            setMessage(result.message);
            await checkEntitlement();
        } catch (err) {
            setMessage(err.data?.message ?? err.message);
        }
    }
 
    async function checkEntitlement() {
        try {
            const result = await entitlement();
            setIsPremium(result.is_premium);
        } catch (err) {
            console.error('Entitlement check failed:', err);
        }
    }
 
    if (isPremium) {
        return <p>You have an active subscription.</p>;
    }
 
    return (
        <div>
            {productList.map((product) => (
                <div key={product.id}>
                    <h3>{product.title}</h3>
                    <p>{product.description}</p>
                    <p>{product.price_formatted}</p>
                    {product.introductory_offer && (
                        <p>
                            Start with {product.introductory_offer.price_formatted} for{' '}
                            {product.introductory_offer.billing_cycle_count}{' '}
                            {product.introductory_offer.period.unit}(s)
                        </p>
                    )}
                    <button onClick={() => buyProduct(product.id)}>Subscribe</button>
                </div>
            ))}
            <button onClick={restorePurchases}>Restore Purchases</button>
            {message && <p>{message}</p>}
        </div>
    );
}

try {
    const result = await purchase('com.app.premium_monthly');
} catch (err) {
    console.error(err.message); // Human-readable message
    console.error(err.code);    // Error code (e.g. "user_cancelled")
    console.error(err.data);    // Full response object from the bridge
}

use Developernauts\NativephpInappPurchases\Facades\InApp;
 
$result = InApp::products(['com.app.premium_monthly', 'com.app.premium_yearly']);
 
if ($result['ok']) {
    foreach ($result['products'] as $product) {
        echo $product['title'];           // "Premium Monthly"
        echo $product['price_formatted']; // "$9.99"
        echo $product['type'];            // "auto_renewable"
    }
}

[
    'id'                  => 'com.app.premium_yearly',
    'title'               => 'Premium Yearly',
    'description'         => '…',
    'price'               => 990.0,           // recurring price
    'price_formatted'     => 'R990.00',
    'currency'            => 'ZAR',
    'type'                => 'auto_renewable',
    'subscription_period' => ['value' => 1, 'unit' => 'year'],
    'introductory_offer'  => [
        'price'               => 0.0,
        'price_formatted'     => 'Free',
        'billing_cycle_count' => 1,
        'period'              => ['value' => 2, 'unit' => 'week'],
    ],
]

$result = InApp::product('com.app.premium_monthly');
 
// Success: ['ok' => true, 'product' => ['id' => '...', 'title' => '...', ...], 'platform' => '...', 'environment' => '...']
// Not found: ['ok' => false, 'error' => 'product_not_found', 'message' => 'Product not found', 'productId' => 'com.app.premium_monthly']

use Developernauts\NativephpInappPurchases\Facades\InApp;
 
// Basic purchase
$result = InApp::purchase('com.app.premium_monthly');
 
// With quantity (consumables only)
$result = InApp::purchase('com.app.coins_100', quantity: 2);
 
// With app account token (for server-side user association)
$result = InApp::purchase('com.app.premium_monthly', appAccountToken: '550e8400-e29b-41d4-a716-446655440000');
 
if ($result['ok']) {
    $transaction = $result['transaction'];
    echo $transaction['id'];          // Transaction ID
    echo $transaction['environment']; // "xcode", "sandbox", or "production"
}

[
    'ok' => true,
    'message' => 'Purchase successful',
    'productId' => 'com.app.premium_monthly',
    'transaction' => [
        'id' => 123456789,
        'originalId' => 123456789,
        'productId' => 'com.app.premium_monthly',
        'purchaseDate' => '2024-01-15T10:30:00Z',
        'expirationDate' => '2024-02-15T10:30:00Z',  // optional
        'revocationDate' => null,                     // optional
        'ownershipType' => 'purchased',
        'environment' => 'sandbox',
        'jws' => 'eyJhbGciOiJFUzI1NiIs…',   // iOS — verification proof
        // 'purchaseToken' => '…',           // Android — verification proof
    ]
]

use Developernauts\NativephpInappPurchases\Facades\InApp;
 
$result = InApp::restore();
 
if ($result['ok']) {
    foreach ($result['transactions'] as $transaction) {
        echo $transaction['productId'];
        echo $transaction['environment'];
    }
}

[
    'ok' => true,
    'message' => 'Restored 2 purchase(s)',
    'transactions' => [
        [
            'id' => 123456789,
            'originalId' => 123456789,
            'productId' => 'com.app.premium_yearly',
            'purchaseDate' => '2024-01-15T10:30:00Z',
            'expirationDate' => '2025-01-15T10:30:00Z',
            'ownershipType' => 'purchased',
            'environment' => 'production'
        ]
    ]
]

use Developernauts\NativephpInappPurchases\Facades\InApp;
 
// Check all entitlements
$result = InApp::entitlement();
 
if ($result['is_premium']) {
    // User has at least one active entitlement
}
 
// Filter by specific product IDs
$result = InApp::entitlement(['com.app.premium_monthly', 'com.app.premium_yearly']);

[
    'ok' => true,
    'message' => 'Found 1 entitlement(s)',
    'platform' => 'ios',
    'is_premium' => true,
    'entitlements' => [
        [
            'id' => 123456789,
            'originalId' => 123456789,
            'productId' => 'com.app.premium_yearly',
            'purchaseDate' => '2024-01-15T10:30:00Z',
            'expirationDate' => '2025-01-15T10:30:00Z',
            'ownershipType' => 'purchased',
            'environment' => 'production'
        ]
    ]
]

$result = InApp::purchase('com.app.premium_monthly');
 
if ($result['ok']) {
    $validation = $result['server']['validation'];  // new additive key
    $validated  = $result['validated'];             // bool|null
    $expiresAt  = $result['expiresAt'] ?? null;    // ISO 8601 | null
}

$result = InApp::entitlement();
 
// is_premium is:
//   true  — if server confirms at least one entitlement is 'active'
//   false — if server says all entitlements are expired/revoked
//   native value — if any result is unverified or missing
if ($result['is_premium']) { ... }

$result['server']['validation'] = [
    'ok'        => true,             // did the server call succeed?
    'validated' => true,             // bool | null (null = skipped/unavailable)
    'status'    => 'active',         // 'active'|'expired'|'revoked'|'unverified'|'unknown'
    'expiresAt' => '2025-01-15T…',  // ISO 8601 | null
    'error'     => null,
    'message'   => null,
    'raw'       => [...],            // small excerpt of the raw API response
];

INAPP_SERVER_VALIDATION_ENABLED=true
INAPP_VALIDATION_CACHE_TTL=300   # seconds; 0 disables caching

APPLE_BUNDLE_ID=com.yourapp.id
APPLE_ISSUER_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
APPLE_KEY_ID=XXXXXXXXXX
APPLE_IAP_ENV=production  # or sandbox
 
# Option A — multiline PEM (use literal \n in .env)
APPLE_PRIVATE_KEY="-----BEGIN EC PRIVATE KEY-----\nMHQC…\n-----END EC PRIVATE KEY-----"
 
# Option B — base64-encoded PEM
APPLE_PRIVATE_KEY=LS0tLS1CRUdJTiBFQ…
 
# Option C — path to a .p8 file on the server filesystem (local dev / CI only)
APP_STORE_API_KEY_PATH=/secure/path/AuthKey_XXXXXXXXXX.p8

# Enable validation
INAPP_SERVER_VALIDATION_ENABLED=true
 
# These NativePHP vars double as fallbacks for bundle_id, key_id, and issuer_id.
NATIVEPHP_APP_ID=com.yourcompany.yourapp
APP_STORE_API_KEY_ID=XXXXXXXXXX
APP_STORE_API_ISSUER_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
 
# Path to the .p8 file — only needs to exist where PHP runs (backend / CI).
APP_STORE_API_KEY_PATH=./credentials/AuthKey_XXXXXXXXXX.p8

# Either set GOOGLE_PLAY_PACKAGE_NAME explicitly, or let NATIVEPHP_APP_ID fill it.
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON=/secure/path/service-account.json

GOOGLE_PLAY_PACKAGE_NAME=com.yourapp.id
 
# Option A — raw JSON string
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON='{"type":"service_account","client_email":"…","private_key":"…","token_uri":"…"}'
 
# Option B — path to the downloaded JSON file
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON=/etc/secrets/google-play-service-account.json

// Example fallback payload:
$result['server']['validation'] = [
    'ok'        => true,
    'validated' => null,
    'status'    => 'unverified',
    'expiresAt' => null,
    'error'     => 'validation_unavailable',
    'message'   => 'Apple validation not configured.',
    'raw'       => null,
];

$entitlement = InApp::entitlement();
 
if ($entitlement['is_premium']) {
    // User has active entitlement on this platform
 
    $platform = $entitlement['platform']; // "ios" or "android"
 
    // For subscription expiration, you may need server-side verification on Android
    if ($platform === 'ios') {
        $expiresAt = $entitlement['entitlements'][0]['expirationDate'] ?? null;
    }
}

// Direct restore call
$raw = nativephp_call('InAppPurchases.Restore', '{}');
$result = json_decode($raw, true)['data'] ?? [];
 
// Direct entitlement call with filter
$raw = nativephp_call('InAppPurchases.Entitlement', json_encode([
    'productIds' => ['com.app.premium_monthly']
]));
$result = json_decode($raw, true)['data'] ?? [];

nativephp-inapp-purchases/
├── nativephp.json                                    # Plugin manifest
├── src/                                              # PHP code (facade, manager, service provider)
└── resources/
    ├── js/index.js                                   # JavaScript bridge library for SPA apps
    ├── boost/guidelines/core.blade.php               # AI assistant guidelines
    ├── ios/Sources/InAppPurchasesFunctions.swift      # iOS StoreKit 2 implementation
    └── android/src/InAppPurchasesFunctions.kt         # Android Google Play Billing implementation

composer test