Como reduzir taxas das lojas de aplicativos com compras no app

Redirecione o checkout do app para a web em conformidade

Link para um navegador externo: desenvolvedores que usam um WebView no app dificilmente passarão pela análise da iOS App Store. Redirecione para um navegador externo para manter a conformidade.

Verifique o país de distribuição: atualmente, a Apple oferece suporte apenas ao Japão, à Coreia do Sul, à UE e aos Estados Unidos. Confira sua região.

Use uma solução pronta para garantir a conformidade: além das diretrizes da Apple, é necessário cumprir regras governamentais, bancárias e das redes de pagamento aplicáveis. Isso inclui padrões de segurança como PCI, normas de privacidade como o GDPR da UE e a CCPA da Califórnia e divulgações exigidas por bancos e empresas de cartão. Podemos orientar você sobre esses requisitos.

Quando usar pagamentos externos

A Apple permite que apps elegíveis do App Store dos Estados Unidos direcionem usuários para fora do app para comprar conteúdo ou serviços digitais em situações específicas. Jogos, associações, assinaturas, bens virtuais e conteúdo digital ganham uma alternativa às compras no app da Apple (IAP).

Conforme as diretrizes de revisão da Apple 3.1.1 e 3.1.1(a), apps da loja dos Estados Unidos podem incluir botões, links externos ou outras chamadas para ação que levem a mecanismos diferentes de IAP para comprar conteúdo ou serviços digitais.

• Itens de jogo, moeda virtual, níveis e conteúdo virtual
• Associações e assinaturas
• Conteúdo e serviços digitais
• Apps que desejam usar checkout Web/H5 de terceiros para compras externas

As regras atuais da Apple não exigem solicitar o StoreKit External Purchase Link Entitlement para mostrar botões, links ou chamadas de compra externa na loja dos Estados Unidos. Antes do lançamento, o comerciante deve confirmar a aplicabilidade do modelo de negócio, categoria do app, tipo de produto e regras mais recentes de revisão da Apple ao seu caso.

Pagamento externo é mais que um link

Adicionar uma entrada de pagamento externo parece simples, mas um checkout confiável exige mais que redirecionamento. É necessário gerenciar pedidos, confirmação do pagamento, entrega de produtos ou direitos, validação de notificações, reembolsos, exceções e conciliação.

Ao retornar do checkout web, o app não deve depender apenas do resultado do cliente. Parâmetros de retorno melhoram a experiência, mas não comprovam o pagamento. O resultado definitivo deve vir da notificação do servidor de WooshPay ou da consulta do pedido.

Como WooshPay apoia o checkout externo

WooshPay oferece checkout móvel Web/H5 que recebe usuários da entrada de compra externa do app e os orienta a concluir o pagamento no navegador.

• Criação de sessões de pagamento
• Exibição do comerciante, produto, valor, moeda e validade do pedido
• Meios comuns nos Estados Unidos, como cartões de crédito e débito, e carteiras conforme a elegibilidade do negócio
• Estados de pagamento bem-sucedido, falha, pendente, encerrado e relacionados a reembolsos
• Notificações do resultado do pagamento pelo servidor
• Consultas de pedidos, reembolsos, conciliação e relatórios de transações
• Verificação de assinaturas, controle de risco, limites, prevenção de fraude, testes em sandbox e verificações de lançamento

Fluxo de pagamento recomendado

Ao tocar na entrada de compra externa do app, o comerciante cria um pedido com identificador único. O servidor fixa produto, valor, moeda, ID do usuário, canal e validade e cria uma sessão de pagamento de WooshPay.

O usuário paga no checkout Web/H5 de WooshPay. Quando o estado muda, WooshPay envia uma notificação ao notify_url do comerciante. O servidor verifica assinatura, ID do pedido, valor, moeda e ID do comerciante antes de conceder o direito digital.

Ao retornar ao app, consulte o estado do pedido no servidor do comerciante, sem confiar nos parâmetros de redirecionamento do cliente.

O que o comerciante deve preparar

• Configurar uma entrada clara para compras externas no app
• Informar claramente que o usuário irá a uma página web ou checkout seguro para concluir a compra
• Criar pedidos com identificadores do comerciante globalmente únicos
• Fixar produto, valor, moeda, ID do usuário, canal e validade do pedido
• Suportar estados como aguardando pagamento, em processamento, sucesso, falha, encerrado e reembolsado
• Configurar notify_url para notificações de pagamento, reembolso e encerramento do pedido
• Verificar assinaturas, IDs de pedidos, valores, moedas e IDs de comerciante nas notificações
• Processar notificações de forma idempotente para evitar entregas duplicadas
• Conceder associações, assinaturas, moeda virtual, itens de jogo ou outros direitos digitais somente após confirmação do servidor
• Tratar notificações e pagamentos duplicados, pedidos vencidos, reembolsos, reversões e pedidos anormais

Não é necessário reportar pagamentos de terceiros à Apple

No cenário dos Estados Unidos descrito no documento original, o comerciante não precisa reportar transações de terceiros à Apple. Ainda deve manter registros completos de transações, reembolsos, conciliação, risco e suporte para suas necessidades operacionais e financeiras.

Um checkout mais flexível para usuários do App Store dos Estados Unidos

Pagamentos externos oferecem outra forma de compra para apps de conteúdo e serviços digitais nos Estados Unidos. WooshPay conecta entradas de compra do app ao checkout Web/H5, com controle do pagamento, entrega, reembolsos e conciliação no servidor.

WooshPay reduz a complexidade de integração, melhora o gerenciamento de estados de pedidos e transforma links de compras externas em uma solução confiável, auditável e escalável.

No Japão, a compra externa é mais que um link de pagamento

A Apple permite que apps iOS elegíveis no Japão usem compras externas em situações específicas. Os distribuidores de jogos podem manter Apple IAP disponível e também oferecer pagamento no navegador padrão do dispositivo.

Não basta adicionar um link de pagamento ao produto. Desenvolvedores precisam tratar entitlement da Apple, elegibilidade regional e do dispositivo, destaque equivalente de IAP, Apple Disclosure, navegador padrão, retorno por Universal Link, entrega no servidor e requisitos de reporte à Apple.

WooshPay conecta essas etapas com SDK, Hosted Checkout e serviço de dados de reporte para jogos iOS, criando um fluxo externo pronto para lançamento, auditável e mais fácil de conciliar.

Aplicabilidade da solução

• Usuários de iPhone na loja japonesa
• iOS 26.2 ou posterior
• Jogos que solicitaram e configuraram o entitlement de compra externa correspondente da Apple
• Compras de produtos digitais que precisam de pagamento no navegador junto com Apple IAP
• Bens digitais do jogo, como itens, moeda virtual, níveis e conteúdo virtual

Antes do lançamento, confirme a aplicabilidade na documentação mais recente da Apple Developer, nos requisitos de revisão, no modelo de negócio e na estratégia de publicação.

Como WooshPay apoia todo o fluxo de compra

Ao tocar na entrada externa na página do produto, WooshPay SDK executa primeiro as verificações da Apple em tempo de execução. Se o jogador e o contexto forem elegíveis, exibe Apple Disclosure e, após confirmação, abre WooshPay Hosted Checkout no navegador padrão.

Após pagar, o jogador pode voltar por Universal Link. O cliente não deve entregar itens usando apenas a URL de retorno: o servidor do jogo deve consultar o estado definitivo de WooshPay ou processar seu webhook antes da entrega.

Principais recursos

1. Verificação de elegibilidade antes de cada compra

O SDK deve executar canMakePayments e isEligible a cada tentativa, sem depender apenas de resultados armazenados na inicialização. Restrições do usuário, loja, versão do iOS e entitlement podem afetar o resultado.

2. Suporte a iOS 26.2/26.3 e iOS 26.4+

Compras externas no Japão estão disponíveis desde iOS 26.2+. Os fluxos de tokens e reporte diferem entre iOS 26.2/26.3 e iOS 26.4+. WooshPay SDK pode suportar ambos mantendo uma jornada de compra consistente.

3. Gestão de tokens LINK_OUT e criação de registro

No iOS 26.4+, o SDK obtém um token LINK_OUT antes de cada transação potencial e o envia ao WooshPay Server antes do checkout. O token vincula tentativa de compra, sessão, estado da transação e dados de reporte à Apple.

4. Apple Disclosure antes de abrir o navegador

Apple Disclosure informa que o usuário está deixando o ambiente de compra da Apple para transacionar com o desenvolvedor ou terceiro. O SDK deve usar a API da Apple, não uma interface própria semelhante. Se o jogador fechar ou rejeitar o aviso, retorne estado cancelado sem abrir o navegador.

5. Hosted Checkout no navegador padrão

Links externos devem abrir página ou aba no navegador padrão, não WKWebView nem outra página de pagamento embutida no app. WooshPay Hosted Checkout gerencia meios de pagamento, risco, estados, resultados e o botão de retorno ao jogo.

A entrega deve usar o estado definitivo do servidor

Universal Link retorna o jogador ao app com contexto de pedido consultável, mas não comprova o pagamento. return_url não deve conter um parâmetro manipulável success=true que ative a entrega diretamente.

O estado definitivo deve vir do WooshPay Server. Recomenda-se combinar notificações webhook e consultas ativas. O servidor só deve conceder associações, assinaturas, moeda virtual, itens e outros direitos quando o pedido estiver em SUCCESS e valor, moeda, pedido e identidade do jogador coincidirem.

O que o desenvolvedor do jogo deve tratar

WooshPay integra pagamento, abertura do navegador e dados de reporte, mas o desenvolvedor ainda tem tarefas essenciais de negócio e conformidade. Elegibilidade Apple, apresentação de produtos, pedidos, entrega e envio de reportes devem ser implementados conforme seu app, produtos e contas de jogadores.

Configuração da Apple e do App Store

• Confirmar que app, tipo de produto, região do jogador e cenário de negócio estão no escopo de compras externas da Apple no Japão.
• Solicitar e configurar o entitlement de compra externa correspondente na Apple Developer ou no App Store Connect.
• Definir jp como região permitida no arquivo entitlements do Xcode e verificar que o pacote de produção inclui a configuração.
• Manter alinhados bundle identifier, conta Apple, ambiente de lançamento e app aprovado.
• Revisar documentação e diretrizes da Apple atualizadas antes do lançamento para reduzir riscos de revisão por mudanças de política.

Página de produto e entrada de compra

• Projetar a entrada externa na página do produto, detalhe do item ou recarga e exibi-la somente em situações elegíveis.
• Manter Apple IAP disponível e ao menos tão destacado quanto a opção externa em posição, peso visual, texto e orientação.
• Informar claramente que o jogador sairá do app para pagar no navegador ou checkout seguro.
• Evitar sugerir que a Apple processa a compra externa e evitar descontos, cores ou layouts que desviem claramente os usuários de IAP.
• Se canMakePayments ou isEligible falhar, ocultar ou desativar a entrada externa ou orientar para Apple IAP conforme a estratégia do produto.

Integração do cliente e retorno ao app

• Inicializar WooshPay SDK ao iniciar o app com merchantId, environment, returnUniversalLink e nível de log.
• Chamar purchase somente quando o jogador tocar ativamente na entrada externa; não iniciar o fluxo sem ação do usuário.
• Configurar domínio de Universal Link, arquivo apple-app-site-association e Associated Domains.
• Tratar estados do cliente: sucesso, pendente, falha, cancelado, erro ao abrir o navegador e fallback de Universal Link.
• Não armazenar chaves privadas da Apple API, issuer ID, key ID nem outras credenciais sensíveis de reporte no cliente.

Pedidos e entrega no servidor

• Criar merchant_order_id globalmente único e fixar produto, valor, moeda, jogador, servidor, personagem e validade do pedido.
• Integrar APIs de servidor de WooshPay para criar sessões, consultar pedidos, receber webhooks e processar reembolsos.
• Verificar assinaturas webhook, IDs de pedidos, valores, moedas, identidade do jogador e proteção contra repetição.
• Realizar todas as entregas no servidor do comerciante, com idempotência por merchant_order_id ou transaction_id.
• Definir regras para PENDING, FAILED, CANCELLED, EXPIRED e REFUNDED para evitar entregas antecipadas ou duplicadas.
• Se o pagamento concluir sem retorno ao app, o webhook ainda deve acionar a entrega no servidor; o jogador verá o direito atualizado na próxima consulta de estado.

Reporte, conciliação e operações

• Obter payloads ou arquivos de reporte para a Apple por WooshPay Reporting API ou Dashboard.
• Enviar reportes à Apple com credenciais/JWT próprios do comerciante, mantendo a responsabilidade por prazos e precisão.
• Criar verificações, novas tentativas e trilhas de auditoria para transações bem-sucedidas, reembolsos, cancelamentos, vencimentos, tokens sem transação e correções.
• Conciliar registros de pagamento de WooshPay, entregas do jogo, reembolsos e reportes à Apple nos processos financeiros.
• Preparar SOPs de suporte e operações para cancelamentos, pagamentos pendentes, cobrança sem entrega, pagamento sem retorno, reembolsos e recuperação de direitos.

Dados de reporte à Apple e limites de responsabilidade

O risco de reporte no Japão também inclui cancelamentos, vencimentos, pagamentos falhos, tokens sem transação, reembolsos e correções. SDK e servidor devem tratar esses casos como estados formais de negócio, não como ruído nos logs.

O serviço de reporte de WooshPay mantém o registro de tokens e mapeia transações, reembolsos, cancelamentos, vencimentos e resultados sem transação para payloads ou arquivos destinados à Apple.

Por padrão, WooshPay não guarda a chave privada da Apple API, issuer ID ou key ID do comerciante nem envia reportes em seu nome. O comerciante usa suas próprias credenciais/JWT, mantendo controle das credenciais e responsabilidade jurídica e financeira.

Crie compras externas para jogos iOS no Japão com WooshPay

Compras externas oferecem um novo caminho de pagamento para jogos iOS no Japão e trazem requisitos de engenharia, revisão e reporte. WooshPay conecta SDK, Hosted Checkout, sincronização de estados e geração de dados para lançar uma experiência controlada, conciliável e escalável.

WooshPay reduz desenvolvimento repetido dos fluxos Apple, simplifica abertura do navegador e retorno ao app, permite entrega com estado definitivo do servidor e prepara dados estruturados e auditáveis para reportes à Apple.