AdPay
How It Works Documentation Contact

AdPay Integration Steps

1. Getting Started

Set up your AdPay account and create your unique product URL with device ID:

https://adpay.tech/product/<your_product_id>?did=<device_id>

What's happening:

  • You're creating an account in the AdPay system
  • AdPay assigns a unique ID to your product or feature
  • This ID is used to generate your custom AdPay URL
  • You're adding a device ID parameter to the URL for user tracking
  • The URL will be the entry point for users to start earning points

2. Add the "Unlock With Ads" Button

Include the AdPay button on your payment page, incorporating the device ID:

<a href="https://adpay.tech/product/<your_product_id>?did=<device_id>" class="adpay-button">Unlock With Ads</a>

What's happening:

  • You're adding a new payment option to your existing payment flow
  • The button redirects users to your custom AdPay URL with their device ID
  • Users can choose between traditional payment and the AdPay option
  • This gives users flexibility in how they access premium features
  • The device ID ensures user progress is tracked accurately

3. Handle Redemptions

Set up a unique postback URL for each product to handle redemptions:

https://your-app.com/adpay-callback/<product_id>?device_id={device_id}&email={email}&player_id={player_id}

What's happening:

  • You'll set up a separate postback URL for each product in your AdPay dashboard
  • Users complete offers and earn points through the AdPay system
  • When a user earns enough points to cover the cost of your product, AdPay triggers the redemption process
  • AdPay sends a GET request to the specific postback URL associated with the earned product
  • Your app should verify the redemption and grant access to the corresponding premium feature
  • Available macros for the postback URL: {device_id}, {email}, {player_id}

Important:

  • Ensure your server can handle GET requests to the postback URL and process the provided parameters securely.
  • The postback will only be triggered when the user has earned enough points to cover the full cost of the product.
  • Set up different postback URLs for each product to easily distinguish between redemptions for various features or items.

Postback URL Setup Example

Here's how you might set up postback URLs for different products:

Product A (ID: premium_feature_1):
https://your-app.com/adpay-callback/premium_feature_1?device_id={device_id}&email={email}&player_id={player_id}

Product B (ID: in_game_currency_pack):
https://your-app.com/adpay-callback/in_game_currency_pack?device_id={device_id}&email={email}&player_id={player_id}

Product C (ID: ad_free_version):
https://your-app.com/adpay-callback/ad_free_version?device_id={device_id}&email={email}&player_id={player_id}

When setting up these URLs in your AdPay dashboard, you'll associate each one with the corresponding product or feature in your app.

Best Practices

Clear Communication

Explain the AdPay option clearly to your users, including how they can earn points and unlock premium features.

Seamless Integration

Ensure a smooth transition to the AdPay portal and back to your app after redemption.

Consistent Styling

Match the AdPay button to your app's design for a cohesive user experience.

Thorough Testing

Test the integration thoroughly, including the postback URL functionality, before launching to ensure a smooth user experience.

Troubleshooting

If you encounter any issues during integration or with postback URL setup, please contact our support team:

[email protected]

Ready to Integrate AdPay?

Boost your app's revenue and user engagement with our AdGem offerwall integration.

Get Started