Alle artikelen
Handleiding8 min leestijd

Offer codes voor in-app-aankopen hebben de promocodes van Apple vervangen, en elke betaalde inwisseling kan alsnog terugkomen als terugbetaling

De offer codes van Apple dekken nu verbruiksartikelen, niet-verbruiksartikelen en niet-verlengbare abonnementen, gratis of met korting. Zo bereikt een terugbetaalde offer-code-aankoop je server, dit kost hij je aan rekenkracht en uitbetalingen, en met deze instellingen voorkom je dat een codecampagne een terugbetalingslek wordt.

Een smartphone op een houten bureau met een leeg codeveld naast een gedrukte promotiekaart, het moment van inwisselen achter offer codes voor in-app-aankopen

Belangrijkste inzichten

  • Sinds 26 maart 2026 kunnen ontwikkelaars in App Store Connect geen promocodes voor In-App Purchases meer aanmaken. De offer codes van Apple vervangen ze, en ze ondersteunen verbruiksartikelen, niet-verbruiksartikelen, niet-verlengbare abonnementen en automatisch verlengbare abonnementen.
  • Een Apple offer code kan een Free Offer zijn of een Paid Offer tegen een verlaagde prijs. Een betaalde inwisseling is een echte aankoop, dus de klant kan Apple om een terugbetaling vragen zoals bij elke andere transactie.
  • Wisselt een klant een offer code in voor een verbruiksartikel, niet-verbruiksartikel of niet-verlengbaar abonnement, dan stuurt App Store Server Notifications V2 ONE_TIME_CHARGE. De ondertekende transactie bevat offerType 3 en offerDiscountType ONE_TIME.
  • Apple stuurt een CONSUMPTION_REQUEST wanneer een klant een terugbetaling aanvraagt voor elk producttype, ook voor offer-code-aankopen. De ontwikkelaar heeft 12 uur om te antwoorden via Send Consumption Information, en alleen met toestemming van de klant.
  • App Store Connect staat per app tot 10 actieve offer-code-aanbiedingen toe, en tot 1 miljoen eenmalige codes plus 1 miljoen aangepaste codes per app per kwartaal, gedeeld over alle In-App Purchases.
  • De geschiktheid en prijs van een offer code kun je na het aanmaken van de aanbieding niet meer wijzigen. Elke klant kan één code per aanbieding inwisselen, en een aanbieding deactiveren laat de codes direct verlopen zonder eerdere inwisselingen te raken.
  • Promocodes van Google Play geven eenmalige producten gratis weg, dus er ontstaat geen betaling om terug te storten. Google staat tot 500 promocodes voor niet-abonnementen per app per kwartaal toe.

Sinds 26 maart 2026 kun je in App Store Connect geen promocodes voor In-App Purchases meer aanmaken. De offer codes van Apple voor in-app-aankopen namen hun plaats in, en ze kunnen iets wat de oude codes niet konden: geld vragen. Een Paid Offer verkoopt een verbruiksartikel, een niet-verbruiksartikel of een niet-verlengbaar abonnement met korting. Daardoor is elke betaalde inwisseling een aankoop waarvoor de klant Apple om een terugbetaling kan vragen, nadat je servers, modelaanroepen en uitbetalingen al tegen volle kosten zijn gedraaid.

Zo werken offer codes voor in-app-aankopen nu

Apple kondigde de wijziging aan op 29 oktober 2025. Offer codes waren vroeger een tool voor abonnementen. Nu dekken ze naast automatisch verlengbare abonnementen ook verbruiksartikelen, niet-verbruiksartikelen en niet-verlengbare abonnementen. De StoreKit-documentatie van Apple beschrijft ze als alfanumerieke codes die In-App Purchases voor een bepaalde periode met korting of gratis aanbieden. Bestaande IAP-promocodes blijven inwisselbaar tot ze verlopen, en promocodes voor gratis app-downloads bestaan nog steeds.

Bij het aanmaken van een aanbieding kies je een Free Offer of een Paid Offer. Voor een betaalde aanbieding stel je een verlaagde prijs in voor een basisland of -regio, en App Store Connect vult vergelijkbare prijzen in voor alle 175 storefronts. Je kiest ook wie in aanmerking komt, uit drie opties: nooit gekocht in je app, gekocht in je app in de afgelopen 30 dagen, of meer dan 30 dagen geleden gekocht. Selecteer je alle drie, dan staat de aanbieding open voor iedereen.

De drie soorten codes

CodetypeVolumeVervaldatumWaar klanten inwisselen
Eenmalige codes500 tot 25.000 per batch, tot 1 miljoen per app per kwartaalVerplicht, tot 6 maandenInwissel-URL, App Store of in je app
Aangepaste codes (je eigen woord, zoals SUMMER25)Tot 25.000 inwisselingen tegelijk, tot 1 miljoen per app per kwartaalOptioneel, tot 6 maanden of zonder einddatumInwissel-URL of in je app
Sandbox-codes10 tot 10.000 per batchOptioneel, tot 6 maandenSandbox-accountinstellingen op een apparaat

Elke app kan tot 10 actieve aanbiedingen tegelijk hebben, en elke klant kan één code per aanbieding inwisselen. Inwisselen in de app vereist voor eenmalige producten iOS 16.3, macOS 15.0 of visionOS 1.0 of nieuwer.

Hoe een terugbetaalde offer-code-aankoop eruitziet op je server

Een inwisseling gebeurt vaak buiten je app. Klanten kunnen een eenmalige code in de App Store typen of een inwissel-URL openen, en Apple vraagt ze je app te downloaden als ze die nog niet hebben. Je server hoort het eerder dan je app.

Voor een verbruiksartikel, niet-verbruiksartikel of niet-verlengbaar abonnement stuurt App Store Server Notifications V2 ONE_TIME_CHARGE. Voor een automatisch verlengbaar abonnement stuurt het SUBSCRIBED bij een nieuwe aankoop of heraanmelding, en OFFER_REDEEMED bij een actieve abonnee. De ondertekende transactie vertelt je dat de aankoop van een code kwam.

TransactieveldWaarde bij een offer-code-aankoopWaarom het telt voor terugbetalingen
offerType3Markeert de aankoop als offer-code-inwisseling
offerIdentifierDe identifier van de aanbieding in App Store ConnectVertelt je bij welke campagne de terugbetaling hoort
offerDiscountTypeONE_TIME voor verbruiksartikelen, niet-verbruiksartikelen en niet-verlengbare abonnementenScheidt codes voor eenmalige producten van abonnementsaanbiedingen
priceDe verlaagde prijs, in milliunitsLaat zien wat de klant echt betaalde, en dus wat een terugbetaling teruggeeft

Lees je nog het oude app-ontvangstbewijs uit, let dan op: het verouderde veld offer_code_ref_name van Apple wordt niet gevuld voor verbruiksartikelen, niet-verbruiksartikelen en niet-verlengbare abonnementen. Deze inwisselingen zijn zichtbaar in de ondertekende transactie.

Het terugbetalingsverzoek zelf

Aan het terugbetalingstraject verandert niets omdat er een code bij betrokken was. Volgens de documentatie van Apple over Send Consumption Information stuurt de App Store een CONSUMPTION_REQUEST wanneer een klant een terugbetaling aanvraagt voor elk producttype. Heeft de klant toestemming gegeven, dan heb je 12 uur om te antwoorden met customerConsented, deliveryStatus, consumptionPercentage, refundPreference en sampleContentProvided. Zonder toestemming zegt Apple dat je niet moet reageren. Kent Apple de terugbetaling toe, dan volgt een REFUND-melding.

Wat een offer-code-terugbetaling je aan geld kost

De terugbetaling zelf is klein, omdat de klant een verlaagde prijs betaalde. Je leveringskosten dalen niet mee met de prijs. Een code die 1.000 AI-credits met flinke korting verkoopt, veroorzaakt nog steeds modelaanroepen ter waarde van 1.000 credits, gefactureerd tegen het normale tarief van je provider. Een niet-verbruiksartikel dat met een code is ontgrendeld, gebruikt evenveel opslag en bandbreedte als een artikel gekocht tegen de catalogusprijs.

KostenpostAfgestemd op de verlaagde prijs?Teruggewonnen na een terugbetaling?
Model- en API-aanroepen achter verbruikte creditsNeeNee
Rekenkracht en bandbreedte om de content te leverenNeeNee
Opslag voor bestanden die de klant maakte of downloaddeNeeNee
Uitbetalingen aan creators, affiliates of partnersHangt af van je voorwaardenAlleen als je voorwaarden terugvordering toestaan
De verlaagde betalingJaTerug naar de klant

Een hypothetisch voorbeeld maakt het gat concreet. Stel dat een creditpakket normaal $9.99 kost en je code het verkoopt voor $1.99. Een klant die inwisselt, elke credit opmaakt en een terugbetaling krijgt, krijgt $1.99 terug. Je modelprovider factureert nog steeds het volledige gebruik. Vermenigvuldig dat voor een code die op een dealforum is geplaatst, en de echte kosten van de campagne zijn je gebruiksrekening, niet de korting die je had gepland.

Een ontwikkelaarsbureau 's nachts met een laptop die stijgend gebruik toont naast een stapel blanco cadeaukaarten, de leveringskosten die offer codes voor in-app-aankopen na een terugbetaling kunnen achterlaten

Zo voorkom je dat een codecampagne een terugbetalingslek wordt

Elke maatregel hieronder werkt voordat er geld verschuift. Dat maakt ze goedkoper dan elk geschil achteraf.

Kies de geschiktheid bewust

Alle drie de geschiktheidsvakjes aanvinken is de voor de hand liggende verleiding. Overweeg voor een betaalde code op een duur verbruiksartikel om hem te beperken tot mensen die al eerder kochten, omdat je over hen al een geschiedenis hebt. De documentatie van Apple zegt niet of terugbetaalde aankopen als aankopen tellen voor de geschiktheid, dus zie dit niet als een losstaand terugbetalingsfilter.

Gebruik eenmalige codes voor alles wat duur is

Een aangepaste code is één woord dat iedereen kan delen, goed voor tot 25.000 inwisselingen tegelijk. Eenmalige codes zijn willekeurig en werken elk één keer. Als een lek pijn zou doen, gebruik dan eenmalige codes en deel ze één voor één uit.

Deactiveer gelekte codes snel

Een aanbieding deactiveren laat de codes direct verlopen. Klanten die al inwisselden, houden wat ze kregen, en niet-ingewisselde codes gaan niet terug naar je kwartaallimiet. Volg het inwisselvolume per offerIdentifier, zodat je een lek binnen uren opmerkt, niet pas aan het eind van de maand.

Koppel de inwisseling aan een account

Aankopen die in de App Store zijn ingewisseld, komen binnen zonder appAccountToken, omdat je aankoopflow nooit heeft gedraaid. Met het endpoint Set App Account Token van de App Store Server API kan je server er achteraf een koppelen. Daarmee wijst een terugbetaling op een code-aankoop naar een echte gebruiker bij wie je actie kunt ondernemen.

Beantwoord het consumptieverzoek eerlijk

Heeft de klant de credits of content gebruikt, zeg dat dan met een correcte deliveryStatus en consumptionPercentage. Heeft hij de app na het inwisselen nooit geopend, dan kost een terugbetaling je weinig en kost verzet je geloofwaardigheid. Je refundPreference is één input voor de beslissing van Apple. Het is geen veto.

Promocodes van Google Play veroorzaken dit probleem niet

De promocodes van Google Play werken anders. Codes voor betaalde apps en eenmalige producten geven het item gratis weg, en abonnementscodes geven een gratis proefperiode van 3 tot 90 dagen. Een gratis item heeft geen betaling die een klant kan laten terugstorten. Google beperkt promocodes voor niet-abonnementen tot 500 per app per kwartaal, en ongebruikte codes worden niet meegenomen.

Een Google Play-aankoop met korting is een gewone betaalde bestelling en volgt de gebruikelijke regels. Google beslist zelf over selfservice-terugbetalingen in de eerste 48 uur, zonder het jou te vragen. De enige flow die je om bewijs vraagt, is de chargeback-review via orders.reviewrefund, met een venster van 24 uur. Voor bestellingen na 3 augustus 2026 legt Google de aankoopprijs van de chargeback, min de servicekosten van Play, plus de chargebackkosten van de bank bij de ontwikkelaar neer.

Veelgestelde vragen

Kan een klant een terugbetaling krijgen voor iets dat met een Apple offer code is gekocht?
Ja, als hij ervoor betaald heeft. Een Paid Offer-inwisseling is een normale aankoop tegen een verlaagde prijs, dus de klant kan Apple om een terugbetaling vragen. Apple stuurt je een CONSUMPTION_REQUEST, je hebt 12 uur om te antwoorden als de klant toestemming gaf, en een REFUND-melding volgt als Apple de terugbetaling toekent. Een Free Offer heeft geen betaling om terug te storten.
Kan ik nog promocodes voor in-app-aankopen aanmaken?
Nee. Sinds 26 maart 2026 kun je in App Store Connect geen promocodes voor In-App Purchases meer aanmaken. Codes die daarvoor zijn aangemaakt, blijven inwisselbaar tot ze verlopen, en promocodes voor gratis app-downloads zijn nog beschikbaar. Offer codes zijn de vervanging.
Hoe zie ik dat een terugbetaalde transactie van een offer code kwam?
Controleer offerType in de ondertekende transactie. Een waarde van 3 betekent dat de klant een offer code heeft ingewisseld, en offerIdentifier noemt de aanbieding. Voor verbruiksartikelen, niet-verbruiksartikelen en niet-verlengbare abonnementen is offerDiscountType ONE_TIME.
Hoeveel offer codes kan ik aanmaken voor in-app-aankopen?
Tot 1 miljoen eenmalige codes en tot 1 miljoen aangepaste codes per app per kwartaal, gedeeld over alle In-App Purchases. Elke app kan tot 10 actieve aanbiedingen tegelijk hebben, en eenmalige codes komen in batches van 500 tot 25.000.
Wat gebeurt er als een offer code online uitlekt?
Deactiveer de aanbieding in App Store Connect. De codes verlopen direct, klanten die al inwisselden houden wat ze kregen, en niet-ingewisselde codes gaan niet terug naar je kwartaallimiet. Terugbetalingsverzoeken voor eerdere betaalde inwisselingen komen nog steeds binnen als normale CONSUMPTION_REQUEST-meldingen.

Bronnen en verder lezen

RefundHalt

De terugbetalingsautopiloot voor de App Store en Google Play

Lees verder

Het volgende terugbetalingsverzoek is al onderweg.

Stel RefundHalt in binnen de tijd die het kost om nog een supportmail te lezen over een terugbetaling die je niet kon betwisten.