Todos os artigos
Guia prático8 min de leitura

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.

Um smartphone sobre uma mesa de madeira com um campo vazio para digitar um código ao lado de um cartão promocional impresso, o momento do resgate por trás dos offer codes para compras no app

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ódigoVolumeValidadeOnde os clientes resgatam
Códigos de uso únicoDe 500 a 25.000 por lote, até 1 milhão por app por trimestreObrigatória, até 6 mesesURL 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 trimestreOpcional, até 6 meses, ou sem data de términoURL de resgate ou dentro do seu app
Códigos de sandboxDe 10 a 10.000 por loteOpcional, até 6 mesesAjustes 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çãoValor em uma compra com offer codePor que importa para reembolsos
offerType3Marca a compra como resgate de offer code
offerIdentifierO identificador da oferta no App Store ConnectDiz a qual campanha o reembolso pertence
offerDiscountTypeONE_TIME para consumíveis, não consumíveis e assinaturas sem renovaçãoSepara códigos de produtos de compra única de ofertas de assinatura
priceO preço com desconto, em milésimosMostra 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 custoAcompanha o preço com desconto?Recuperado após um reembolso?
Chamadas de modelo e de API por trás dos créditos consumidosNãoNão
Computação e banda para entregar o conteúdoNãoNão
Armazenamento de arquivos que o cliente criou ou baixouNãoNão
Repasses a criadores, afiliados ou parceirosDepende dos seus termosSó se os seus termos permitirem estorno
O pagamento com descontoSimDevolvido 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.

A mesa de um desenvolvedor à noite com um notebook mostrando uso em alta ao lado de uma pilha de cartões-presente em branco, o custo de entrega que os offer codes para compras no app podem deixar depois de um reembolso

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

RefundHalt

O piloto automático de reembolsos para App Store e Google Play

Continue lendo

A próxima solicitação de reembolso já está a caminho.

Configure a RefundHalt no tempo que você levaria para ler mais um e-mail de suporte sobre um reembolso que não conseguiu contestar.