Custom Promo Code Feature

[xhayankhan]

Custom Promo Code feature is not available in Revenue Cat yet, I have created custom promo codes, but there's no field to enter/apply those promo codes. The Auto generated ones can work with playstore but custom code doesn't.

[RCGitBot]

👀 We've just linked this issue to our internal tracker and notified the team. Thank you for reporting, we're checking this out!

[GuilhermeMota93]

Hey @xhayankhan,

Happy to help clarify things here!

RevenueCat doesn't currently provide a field in the paywall or SDK to manually enter promo codes, but promo code redemption is supported and handled by the Google Play purchase flow itself.

On Google Play
If you’ve created custom promo codes (multi-use codes for subscriptions) in the Google Play Console, users must redeem them during the in-app purchase flow:

• after initiating a purchase, the Google Play billing sheet will appear.
• from there, tap the dropdown next to their payment method, choose “Redeem code,” and enter the custom promo code.
• RevenueCat will automatically detect and apply the entitlement after the transaction is processed (no need to implement a custom field in your app’s UI).

Testing Tip:
During development, you can use Google Play’s license testers and Play Billing Lab to simulate and test promo code redemption and other billing flows. This ensures your integration detects promo code redemptions as expected.

Note: Custom promo codes for subscriptions can only be redeemed in-app (not in the Play Store app directly).
One-time codes (auto-generated by Google) can be redeemed both in-app or via the Play Store app.

If this doesn’t match what you’re seeing - or if you’re referring to a different kind of promo code (e.g., an internal system or a non-subscription product) - feel free to share more details:

• where were the codes created?
• how are you expecting users to redeem them?
• what platform(s) are you targeting?

Some extra context:

• Play Billing Promo Codes
• Create Promotions
• RevenueCat Subscription Offers (redeem codes)

Best,

[xhayankhan]

Hi @GuilhermeMota93

First of thank you so much for the reply, it shows the dedication of your team to make sure you provide the best product to your consumers.

So the thing is that there is no option in the payment sheet by google play to enter the promo code or to change the payment option other than card. I am attaching a screenshot for your reference. The product in the screenshot does have active custom promo code.

[GuilhermeMota93]

Hey @xhayankhan ,

Thanks for the added details and apologies for taking a bit longer to reply.

So on that image that you sent, on the Mastercard-6761, if you tap into that are you not able to see a Redeem Code area?

The Google Documentation seems to allow doing that via that or via the Play Store directly:

In your app: The user can initiate the purchase by clicking the down arrow next to the form of payment in the Google Play purchase screen and then clicking the Redeem link to type in the code.

In the Play store: The user can manually enter the code in the Google Play Store by clicking the Play Store left navigation menu and tapping Redeem Code.
The user can also skip manual code entry by instead following a deep link to the Google Play Store.

There's also some helpful guiding images on the above link. Adding them here for easier access:

1

2

3

Could you try that and let me know what you see?

Best,

• Gui from RevenueCat

[xhayankhan]

Hi @GuilhermeMota93 , apologies for the delayed response.
When I tap on the card, this is the screen I see—there’s no option to redeem the code. I’ve confirmed that the codes are currently active. Just to clarify:

Custom codes can only be redeemed through the mobile app

Auto-generated codes can be redeemed via the Play Store

Please let me know how to proceed.

[GuilhermeMota93]

Hey @xhayankhan, thanks for following up!

Hum, I see what you mean. That is odd, but a quick search online showed that it can happen - from my investigation, when the “Redeem code” option doesn’t appear in the Google Play payment sheet (as in, outside of RevenueCat), it can be caused by a few different factors:

Account Age or Family Restrictions
If the user’s Google account is part of a family group, especially one with child restrictions (under 13), the Redeem option may be hidden. This can also happen with Family Link-managed accounts.

Region or Country Mismatch
Promo codes are region-locked. If the user’s Play account country doesn’t match the country the code was issued for, Google may hide the option entirely. This is common if the user is traveling or has recently switched their Play Store country.
📘 Google - Countries list and limitations
📘 Google – Fix Problems With Gift Cards & Codes

Work or School Accounts
If the Google account is managed by an organization (G Suite, school email, etc.), certain payment features (including promo redemptions) may be disabled by the administrator.
📘 Google Help – Redeem Not Working

Play Store or App UI Glitch
A bit more rarer occurrence, but can happen, that corrupted Play Store cache or an outdated version can cause UI elements (like Redeem) to disappear. It seems clearing data or updating the app can make the button reappear.

Inactive or Expired Promo Code
If the code hasn’t been activated yet in the Google Play Console or if it’s already expired, it won’t appear as a redemption option at checkout.)

The appearance of the “Redeem code” option is fully controlled by Google Play’s purchase sheet, so unfortunately it's not something RevenueCat can influence. If the option isn’t showing up, it’s often due to factors like region mismatches, account restrictions (e.g. family or work accounts), or how the promo was configured in the Play Console - all of which fall under Google’s domain.

That said, we’re more than happy to help make sure everything on the RevenueCat side is set up correctly. If you'd like us to take a closer look at your current promo code setup or entitlement configuration, just reach out to us via RevenueCat Support. Feel free to include screenshots of the Play Console setup or your Store config, and link to this thread if helpful.

Best,
Gui from RevenueCat

[ajpallares]

Reopened issue. It was closed due to a failing automation. Sorry about that.

[GuilhermeMota93]

Hey @xhayankhan!

I just wanted to check in and see if you were able to get the Google Sheet to show the option for your codes?