Os offer codes para compras no app substituíram os códigos promocionais da Apple, e cada resgate pago ainda pode voltar como reembolso
Os offer codes da Apple agora cobrem consumíveis, não consumíveis e assinaturas sem renovação, com preço gratuito ou com desconto. Veja como uma compra reembolsada feita com offer code chega ao seu servidor, quanto ela custa em computação e repasses, e quais configurações impedem que uma campanha de códigos vire um vazamento de reembolsos.

Principais conclusões
- Desde 26 de março de 2026, os desenvolvedores não podem mais criar códigos promocionais para In-App Purchases no App Store Connect. Os offer codes da Apple os substituem e aceitam consumíveis, não consumíveis, assinaturas sem renovação e assinaturas com renovação automática.
- Um offer code da Apple pode ser um Free Offer ou um Paid Offer com preço reduzido. Um resgate pago é uma compra real, então o cliente pode pedir à Apple que a reembolse como qualquer outra transação.
- Quando um cliente resgata um offer code de um consumível, não consumível ou assinatura sem renovação, o App Store Server Notifications V2 envia ONE_TIME_CHARGE. A transação assinada traz offerType 3 e offerDiscountType ONE_TIME.
- A Apple envia um CONSUMPTION_REQUEST quando um cliente pede reembolso de qualquer tipo de produto, incluindo compras com offer code. O desenvolvedor tem 12 horas para responder pelo Send Consumption Information, e somente com o consentimento do cliente.
- O App Store Connect permite até 10 ofertas de offer codes ativas por app e até 1 milhão de códigos de uso único mais 1 milhão de códigos personalizados por app, por trimestre, compartilhados entre todos os In-App Purchases.
- A elegibilidade e o preço de um offer code não podem ser editados depois que a oferta é criada. Cada cliente pode resgatar um código por oferta, e desativar uma oferta expira seus códigos na hora, sem afetar os resgates anteriores.
- Os códigos promocionais do Google Play dão produtos de compra única de graça, então não geram nenhuma cobrança para reembolsar. O Google permite até 500 códigos promocionais que não são de assinatura por app, por trimestre.
Em 26 de março de 2026, os códigos promocionais para In-App Purchases deixaram de poder ser criados no App Store Connect. Os offer codes da Apple para compras no app tomaram o lugar deles, e fazem uma coisa que os códigos antigos não faziam: podem cobrar dinheiro. Um Paid Offer vende um consumível, um não consumível ou uma assinatura sem renovação com desconto. Isso transforma cada resgate pago em uma compra que o cliente pode pedir à Apple para reembolsar, depois que seus servidores, chamadas de modelo e repasses já rodaram a custo cheio.
Como os offer codes para compras no app funcionam agora
A Apple anunciou a mudança em 29 de outubro de 2025. Os offer codes eram uma ferramenta para assinaturas. Agora também cobrem consumíveis, não consumíveis e assinaturas sem renovação, além das assinaturas com renovação automática. A documentação do StoreKit da Apple os descreve como códigos alfanuméricos que oferecem In-App Purchases com desconto ou de graça, por um período específico. Os códigos promocionais de IAP existentes continuam valendo até expirarem, e os códigos promocionais para downloads gratuitos de apps ainda existem.
Ao criar uma oferta, você escolhe um Free Offer ou um Paid Offer. Para uma oferta paga, você define um preço com desconto para um país ou região base e o App Store Connect preenche preços equivalentes para todas as 175 vitrines. Você também escolhe quem se qualifica, entre três opções: nunca comprou no seu app, comprou no seu app nos últimos 30 dias, ou comprou há mais de 30 dias. Marcar as três abre a oferta para todo mundo.
Os três tipos de código
| Tipo de código | Volume | Validade | Onde os clientes resgatam |
|---|---|---|---|
| Códigos de uso único | De 500 a 25.000 por lote, até 1 milhão por app por trimestre | Obrigatória, até 6 meses | URL de resgate, App Store ou dentro do seu app |
| Códigos personalizados (uma palavra sua, como SUMMER25) | Até 25.000 resgates por vez, até 1 milhão por app por trimestre | Opcional, até 6 meses, ou sem data de término | URL de resgate ou dentro do seu app |
| Códigos de sandbox | De 10 a 10.000 por lote | Opcional, até 6 meses | Ajustes da conta sandbox em um dispositivo |
Cada app pode ter até 10 ofertas ativas ao mesmo tempo, e cada cliente pode resgatar um código por oferta. O resgate dentro do app exige iOS 16.3, macOS 15.0 ou visionOS 1.0 ou posterior para produtos de compra única.
Como uma compra reembolsada com offer code aparece no seu servidor
O resgate muitas vezes acontece fora do seu app. Os clientes podem digitar um código de uso único na App Store ou abrir uma URL de resgate, e a Apple pede que baixem seu app se ainda não o tiverem. Seu servidor fica sabendo antes do seu app.
Para um consumível, não consumível ou assinatura sem renovação, o App Store Server Notifications V2 envia ONE_TIME_CHARGE. Para uma assinatura com renovação automática, envia SUBSCRIBED em uma compra nova ou reassinatura, e OFFER_REDEEMED para um assinante ativo. A transação assinada informa que a compra veio de um código.
| Campo da transação | Valor em uma compra com offer code | Por que importa para reembolsos |
|---|---|---|
| offerType | 3 | Marca a compra como resgate de offer code |
| offerIdentifier | O identificador da oferta no App Store Connect | Diz a qual campanha o reembolso pertence |
| offerDiscountType | ONE_TIME para consumíveis, não consumíveis e assinaturas sem renovação | Separa códigos de produtos de compra única de ofertas de assinatura |
| price | O preço com desconto, em milésimos | Mostra o que o cliente realmente pagou, e portanto o que um reembolso devolve |
Se você ainda lê o recibo antigo do app, saiba que o campo legado offer_code_ref_name da Apple não é preenchido para consumíveis, não consumíveis e assinaturas sem renovação. É na transação assinada que esses resgates aparecem.
A solicitação de reembolso em si
Nada no fluxo de reembolso muda porque havia um código envolvido. A documentação do Send Consumption Information da Apple diz que a App Store envia um CONSUMPTION_REQUEST quando um cliente pede reembolso de qualquer tipo de produto. Se o cliente consentiu, você tem 12 horas para responder com customerConsented, deliveryStatus, consumptionPercentage, refundPreference e sampleContentProvided. Se ele não consentiu, a Apple diz para não responder. Uma notificação REFUND chega se a Apple aprovar o reembolso.
Quanto um reembolso de offer code custa em dinheiro
O lado do reembolso é pequeno, porque o cliente pagou um preço com desconto. Seus custos de entrega não diminuem com o preço. Um código que vende 1.000 créditos de IA com um desconto grande ainda dispara chamadas de modelo equivalentes a 1.000 créditos, cobradas pela tarifa normal do seu provedor. Um não consumível desbloqueado por código ainda consome o mesmo armazenamento e a mesma banda que um comprado pelo preço cheio.
| Fator de custo | Acompanha o preço com desconto? | Recuperado após um reembolso? |
|---|---|---|
| Chamadas de modelo e de API por trás dos créditos consumidos | Não | Não |
| Computação e banda para entregar o conteúdo | Não | Não |
| Armazenamento de arquivos que o cliente criou ou baixou | Não | Não |
| Repasses a criadores, afiliados ou parceiros | Depende dos seus termos | Só se os seus termos permitirem estorno |
| O pagamento com desconto | Sim | Devolvido ao cliente |
Um exemplo hipotético para deixar a diferença concreta. Digamos que um pacote de créditos custe $9.99 de tabela e seu código o venda por $1.99. Um cliente que resgata, gasta todos os créditos e é reembolsado recebe de volta $1.99. Seu provedor de modelos ainda cobra todo o uso. Se o código for parar em um fórum de promoções, o custo real da campanha é a sua conta de uso, não o desconto que você planejou.

Como impedir que uma campanha de códigos vire um vazamento de reembolsos
Todos os controles abaixo agem antes de o dinheiro se mover, o que os torna mais baratos do que qualquer disputa depois do fato.
Escolha a elegibilidade de propósito
Marcar as três caixas de elegibilidade é a tentação padrão. Para um código pago em um consumível caro, considere limitá-lo a quem já comprou antes, porque você já tem histórico dessas pessoas. A documentação da Apple não diz se compras reembolsadas contam como compras para a elegibilidade, então não trate isso como um filtro de reembolso por si só.
Prefira códigos de uso único para tudo que for caro
Um código personalizado é uma palavra que qualquer pessoa pode compartilhar, válida para até 25.000 resgates por vez. Códigos de uso único são aleatórios e funcionam uma vez cada. Se um vazamento for doer, use códigos de uso único e distribua um por um.
Desative rápido os códigos vazados
Desativar uma oferta faz seus códigos expirarem na hora. Os clientes que já resgataram ficam com o que receberam, e os códigos não resgatados não voltam para o seu limite trimestral. Acompanhe o volume de resgates por offerIdentifier para perceber um vazamento em horas, não no fim do mês.
Vincule o resgate a uma conta
Compras resgatadas na App Store chegam sem appAccountToken, porque o seu fluxo de compra nunca rodou. O endpoint Set App Account Token da App Store Server API permite que o seu servidor anexe um depois. Com ele, um reembolso de uma compra com código aponta para um usuário real sobre o qual você pode agir.
Responda à solicitação de consumo com honestidade
Se o cliente usou os créditos ou o conteúdo, diga isso com deliveryStatus e consumptionPercentage precisos. Se ele nunca abriu o app depois de resgatar, um reembolso custa pouco e resistir custa credibilidade. Sua refundPreference é um dos dados na decisão da Apple. Não é um veto.
Os códigos promocionais do Google Play não criam esse problema
Os códigos promocionais do Google Play funcionam de outro jeito. Códigos para apps pagos e produtos de compra única dão o item de graça, e códigos de assinatura concedem um teste gratuito de 3 a 90 dias. Um item gratuito não tem cobrança para o cliente reembolsar. O Google limita os códigos promocionais que não são de assinatura a 500 por app, por trimestre, e códigos não usados não acumulam.
Uma compra com desconto no Google Play é um pedido pago comum e segue as regras de sempre. O Google decide os reembolsos de autoatendimento nas primeiras 48 horas sem consultar você. O único fluxo que pede provas é a análise de chargeback via orders.reviewrefund, com prazo de 24 horas. Para pedidos feitos depois de 3 de agosto de 2026, o Google repassa ao desenvolvedor o preço de compra do chargeback, menos a taxa de serviço do Play, mais as taxas de chargeback do banco.
Perguntas frequentes
- Um cliente pode ser reembolsado por algo comprado com um offer code da Apple?
- Sim, se ele pagou. O resgate de um Paid Offer é uma compra normal com preço reduzido, então o cliente pode pedir reembolso à Apple. A Apple envia um CONSUMPTION_REQUEST, você tem 12 horas para responder se o cliente consentiu, e uma notificação REFUND chega se a Apple aprovar. Um Free Offer não tem pagamento para reembolsar.
- Ainda posso criar códigos promocionais para compras no app?
- Não. Desde 26 de março de 2026, o App Store Connect não permite mais criar códigos promocionais para In-App Purchases. Códigos criados antes disso podem ser resgatados até expirarem, e os códigos promocionais para downloads gratuitos de apps continuam disponíveis. Os offer codes são o substituto.
- Como sei que uma transação reembolsada veio de um offer code?
- Verifique offerType na transação assinada. O valor 3 significa que o cliente resgatou um offer code, e offerIdentifier indica a oferta. Para consumíveis, não consumíveis e assinaturas sem renovação, offerDiscountType é ONE_TIME.
- Quantos offer codes posso criar para compras no app?
- Até 1 milhão de códigos de uso único e até 1 milhão de códigos personalizados por app, por trimestre, compartilhados entre todos os In-App Purchases. Cada app pode ter até 10 ofertas ativas ao mesmo tempo, e os códigos de uso único vêm em lotes de 500 a 25.000.
- O que acontece se um offer code vazar na internet?
- Desative a oferta no App Store Connect. Os códigos dela expiram na hora, os clientes que já resgataram ficam com o que receberam, e os códigos não resgatados não voltam para o seu limite trimestral. Pedidos de reembolso de resgates pagos anteriores continuam chegando como notificações CONSUMPTION_REQUEST normais.
Fontes e leituras adicionais
- Apple Developer News: Enhancements to help you submit and market your apps and games (October 29, 2025)
- App Store Connect Help: Create offer codes for In-App Purchases
- Apple Developer: Supporting offer codes in your app
- App Store Server API: offerType and offerDiscountType
- App Store Server API: Send Consumption Information
- App Store Server API: Set App Account Token
- Google Play Console Help: Create promo codes
- Google Play Console Help: Updates to refund protection and chargeback cost responsibility
RefundHalt
O piloto automático de reembolsos para App Store e Google Play
Continue lendo
O Brasil agora fiscaliza quais jogos ainda vendem caixas de recompensa a crianças, e a conta chega nos reembolsos de loot boxes
O Ministério da Justiça pediu à autoridade de proteção de dados que monitore seis jogos que vendem caixas de recompensa sem verificar a idade. Veja o que a lei exige, o que Apple e Google já cobram e como precificar e tratar reembolsos de loot boxes quando a caixa já foi aberta.
Compras in-app acidentais são os reembolsos que você não consegue vencer, então a solução está na sua tela de compra
Compras in-app acidentais voltam como reembolsos nas duas lojas, e nenhum dado de uso prova que um toque foi intencional. Veja como a Apple e o Google as classificam, quanto cada uma custa em processamento e repasses, e o design de tela de compra que as impede antes que a cobrança exista.