muhammad-umar/ppp-gateway

Purchasing Power Parity (PPP) fair pricing adjustment by countries with Stripe (or any other payment gateway supported by Laravel Cashier) integration powered by data from the World Bank

v1.0.0 2026-02-24 12:15 UTC

Requires

• php: ^8.2
• illuminate/console: ^11.0|^12.0
• illuminate/database: ^11.0|^12.0
• illuminate/http: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0
• laravel/cashier: ^16.0
• league/iso3166: ^4.3
• trustip/trustip: ^1.1

MIT

• Muhammad Umar

README

Detailed article is availabe at https://docs.agenytics.com/blog/ppp-stripe

Implementing Purchasing Power Parity (PPP) pricing per country for a Stripe Checkout purchase flow. But you can use it for any other payment gateway, like PayPal, Paddle, Lemon Squeezy, etc. This package uses World Bank PPP data and TrustIP to detect VPN/Proxy.

Installation in Existing Laravel Project

1. Install the package

   composer require muhammad-umar/ppp-gateway

2. Publish the assets

   # PPP Data CSV
   php artisan vendor:publish --tag="ppp-gateway-data"

   Optional: You can also publish the config and migrations files:

   php artisan vendor:publish --tag="ppp-gateway-config"
   php artisan vendor:publish --tag="ppp-gateway-migrations"

3. Run migrations

   php artisan migrate

4. Import PPP data

   php artisan import:ppp

We have used lifetime product for demonstration purposes. You can use any other product you want.

1. Configure environment variables

   STRIPE_LIFETIME_PRODUCT_ID=prod_xxxxx
   TRUSTIP_API_KEY=your_trustip_api_key

2. Configure subscription plans

We have subscription-plans.php config file for payment products. You can configure it as you want. You should use this data to show price in frontend, sending PPPService->getAdjustedPriceData() parameter from your Controller.

1. Checkout page

From fronted you should send a POST request to /purchase route (see PPPGatewayServiceProvider.php for route registration). It is binded to PurchaseController that will create a checkout session with adjusted price for the selected country.

License

MIT