Promo codes | Google Play's billing system - Android ...

Promotions, or promo codes, enable you to give one-time products or trials to subscriptions free-of-charge to a limited number of users. Platform AndroidStudio GooglePlay Jetpack Kotlin Docs News Language English BahasaIndonesia Español–AméricaLatina Português–Brasil 中文–简体 中文–繁體 日本語 한국어 Signin GooglePlay Overview PlayConsole PlayIntegrity PlayBilling PlayPolicies Resources Platform AndroidStudio GooglePlay Overview PlayConsole PlayIntegrity PlayBilling PlayPolicies Resources Jetpack Kotlin Docs News GooglePlay'sbillingsystem Overview Terminology Gettingready Integratethelibrary Sellsubscriptions Offerapromotion Testyourintegration Libraryreleasenotes Contactus Additionalguides Fightfraudandabuse MigratefromAIDL Developerpayload UsetheBillingLibrarywithUnity Resources PlayBillingLibraryreference GooglePlayDeveloperAPI Additionalresources Real-timedevelopernotificationsreference Deprecatedcontent AIDLreference Rewardedproducts Reminder:ByNovember1,2021,allupdatestoexistingappsmustuseBillingLibraryversion3ornewer.Learnmore. GooglePlay'sbillingsystem GooglePlay PlayBilling Promocodes Promotions,orpromocodes,enableyoutogiveone-timeproductsortrials tosubscriptionsfree-of-chargetoalimitednumberofusers.Theuserenters apromocode,eitherinyourapporintheGooglePlayStoreapp,andreceives theitemorsubscriptiontrialatnocost. WithinthePlayConsole,youcancreatethefollowingtypesofpromocodes: One-timeusecodes:Theseareautomatically-generateduniquecodesthat userscanredeemonlyonce.Usersredeemthesecodeseitherdirectlyfrom thePlayStoreorfromwithinyourapp. Customcodes:Youcanspecifycustomcodesthatcanberedeemedmultiple timesuptoyourpredefinedlimit.Customcodesareavailableonlyfor subscriptionsandcanberedeemedonlybyuserswhohavenotpreviously subscribed. Youcanusepromocodesinmanywaystocreativelyengagewithusers, includingthefollowing: Youmightdistributecardswithpromocodesatanevent,anduserswould entertheirpromocodestounlockaspecialin-gameitem. Youmightgivecodestoemployeessotheycansharethemwiththeirfriends andfamily. Youmightsendapromocodetopeoplewhobuyyourappduringacertain periodoftime. Forsubscriptions,notethefollowing: Promocodesofferfreetrialstosubscriptionsandnotfreesubscriptions. Promotionsdonotextendotherfreetrials.Ifasubscriptionbeginswitha freetrialwithoutrequiringapromocode,apromotionwouldoverridethe originalfreetriallength. Userswhoaren'teligiblefornon-promofreetrials—forexample,userswho havealreadypurchasedasubscriptioninthepast—arestilleligiblefor afreetrialthroughapromotion. UserscanredeempromocodesintheGooglePlayStoreupuntilapromotion enddatethatyouspecifyinthePlayConsole.Promotionscanlastupto oneyear. Beforeimplementingapromotion,besuretoconsiderthefollowing: Forone-timeproducts,youcancreateupto500promocodesperquarter acrossallmanagedproductsinanapp.Youcanusedifferentcombinationsof promocodesthatincludeoneormoreone-timeproducts.Examplesinclude thefollowing: 500promocodesforasingleone-timeproduct. 100promocodes,eachforfivedifferentone-timeproducts. Forsubscriptionpromotions,youcancreateupto 10,000one-timeusecodesperquarterpersubscriptionproduct.This limitdoesnotcounttowardthelimitofpromocodesforone-timeproducts. Whencreatingasubscriptionpromotionwithcustomcodes,youcanchoosea redemptionlimitbetween2,000and99,999. Note:Onceyoucreateapromotion,youcan'tchangethenumberofpromocodes inthatpromotion,andyoucan'tswitchthosepromocodestoadifferenttype.Note:Ifyoudon'tuseallofyourpromocodesinaquarter,youloseaccess tothem.Unusedcodesdon'tcarryovertothenextquarter. Creatingandmanagingpromotions Tolearnhowtosetupandmanagepromotions,see CreatePromotions. Userredemptionflow Onceauserhasapromocode,theycanredeemitinoneofthefollowingways: Inyourapp:Theusercaninitiatethepurchasebyclickingthedown arrownexttotheformofpaymentintheGooglePlaypurchasescreenand thenclickingtheRedeemlinktotypeinthecode. InthePlaystore:TheusercanmanuallyenterthecodeintheGoogle PlayStorebyclickingthePlayStoreleftnavigationmenuandtapping RedeemCode. Theusercanalsoskipmanualcodeentrybyinsteadfollowinga deeplinktotheGooglePlayStore. Asanexample,figure1showsapurchasescreenforasubscription.Toenter apromocode,tapthearrownexttothecurrentpaymentmethodtoshowthe Paymentmethodsscreen,asshowninfigure2.Next,tapRedeemcode togototheRedeemagiftcardorpromocodescreen,asshowninfigure3. YoucanthenenteryourpromocodeonthisscreenandtapRedeemtofinish. Figure1.Asubscriptionpurchasedialog. Figure2.Screenthatlistspaymentmethodsforanin-app purchase. Figure3.Promocodescreen. Forsubscriptionpromocodes,notethefollowing: Customcodescanberedeemedonlyfromwithinyourapp,whileone-timecodes canberedeemedthroughbothyourappandthePlaystore. Aftertheuserredeemsthecode,theystillneedtopurchasethe subscriptionwiththecodeapplied.Avalidformofpaymentisrequired forthesubscription,andthesubscriptionwillauto-renewattheendof thepromocodefreetrialperiod. IfusingBillingLibraryversion2.0orhigher,auserwhoredeemsa one-timecodefromthePlaystoreisimmediatelyaskedtopurchasethe subscriptionthroughthePlaystore.Thisisanout-of-apppurchase,sobe surethatyourappcan handlethesepurchasesgracefully. IfyourappdoesnotyetsupportBillingLibrary2.0,theusermust downloadyourapp,navigatetothecorrectsubscription,andthenpurchase thesubscriptionfromwithinyourapptousethepromotioncode. Implementingpromocodes Toensureyourappisreadytohandlepromocodes,yourappneedsto properlyhandleredemptionsthatoccuroutsideofyourapp.Tolearnmore, seeProcessingpurchases, Fetchingpurchases,and Handlingpurchasesmadeoutsideofyourapp inIntegratetheGooglePlayBillingLibraryintoyourapp. Deeplink YoucanalsoshareapromocodebygeneratingaURLthatsendstheuserto theGooglePlayStoreandauto-populatestheEntercodefield.Usethe followingformatforapromocodeURL: https://play.google.com/redeem?code=promo_code Figure4showstheGooglePlayapp'sRedeemCodedialog: Figure4.GooglePlayapp'sRedeemCode dialog. AftertheuserpressesRedeem,ifthelatestversionofyourappis installed,theGooglePlayStorepromptstheusertoopentheapp.Otherwise, theGooglePlayStorepromptstheusertoupdateordownloadyourapp. Testingpromocodes Totestyourpromocodeimplementation,see Testpromocodes. ContentandcodesamplesonthispagearesubjecttothelicensesdescribedintheContentLicense.JavaandOpenJDKaretrademarksorregisteredtrademarksofOracleand/oritsaffiliates. Lastupdated2021-10-27UTC. [{ "type":"thumb-down", "id":"missingTheInformationINeed", "label":"MissingtheinformationIneed" },{ "type":"thumb-down", "id":"tooComplicatedTooManySteps", "label":"Toocomplicated/toomanysteps" },{ "type":"thumb-down", "id":"outOfDate", "label":"Outofdate" },{ "type":"thumb-down", "id":"samplesCodeIssue", "label":"Samples/codeissue" },{ "type":"thumb-down", "id":"otherDown", "label":"Other" }] [{ "type":"thumb-up", "id":"easyToUnderstand", "label":"Easytounderstand" },{ "type":"thumb-up", "id":"solvedMyProblem", "label":"Solvedmyproblem" },{ "type":"thumb-up", "id":"otherUp", "label":"Other" }] Twitter Follow@AndroidDevonTwitter YouTube CheckoutAndroidDevelopersonYouTube LinkedIn ConnectwiththeAndroidDeveloperscommunityonLinkedIn MoreAndroid Android AndroidforEnterprise Security Source News Blog Podcasts Discover Gaming MachineLearning Privacy 5G AndroidDevices Largescreens WearOS AndroidTV Androidforcars AndroidThings ChromeOSdevices Releases Android11 Android10 Pie Oreo Nougat Marshmallow Lollipop KitKat DocumentationandDownloads AndroidStudioguide Developersguides APIreference DownloadStudio AndroidNDK Support Reportplatformbug Reportdocumentationbug GooglePlaysupport Joinresearchstudies Android Chrome Firebase GoogleCloudPlatform Allproducts Privacy License Brandguidelines Getnewsandtipsbyemail Subscribe Language English BahasaIndonesia Español–AméricaLatina Português–Brasil 中文–简体 中文–繁體 日本語 한국어