Skip to main content

Introdução

Dodo Payments capacita desenvolvedores a vender bens e serviços digitais em aplicativos iOS, lidando com aspectos complexos como conformidade fiscal, conversão de moeda e pagamentos. Este guia abrangente detalha como integrar o Dodo Payments em seu aplicativo iOS, especificamente para ferramentas SaaS, assinaturas de conteúdo e utilitários digitais.

Visão Geral

Dodo Payments atua como seu Merchant of Record (MoR), gerenciando aspectos críticos do seu negócio digital:
  • Coleta e repasse de tributos (IVA, GST e outros impostos regionais)
  • Pagamentos globais de acordo com políticas e métodos locais
  • Conversão de moeda e câmbio
  • Chargebacks e prevenção de fraudes
  • Faturamento e recibos para o cliente final
  • Conformidade com regulamentações regionais

Casos de Uso

Subscriptions

  • Acesso a conteúdo ou recursos premium
  • Cobrança recorrente com opções flexíveis, testes gratuitos, prorrata, upgrades e downgrades

Courses and Learning

  • Acesso pay-per-course
  • Pacotes de conteúdo combinados
  • Licenças vitalícias ou renováveis
  • Integração de rastreamento de progresso

Digital Downloads

  • Compras pontuais (PDFs, músicas, ferramentas)
  • Entrega de ativos digitais
  • Gerenciamento de chaves de licença

SaaS Tools

  • Assinaturas de Software como Serviço
  • Cobrança baseada no uso
  • Planos para equipes e empresas

Fluxo de Integração

Seu app abre o checkout hospedado do Dodo com o iOS checkout SDK, que o apresenta em SFSafariViewController e devolve um resultado tipado.
Use o SDK em vez de incorporar o checkout em um WebView. O Apple Pay só está disponível em uma superfície de navegador real, portanto um WebView reduz silenciosamente suas conversões de carteira — e fluxos de pagamento dentro de um WebView são uma causa comum de rejeições na revisão da App Store.

Etapas da integração

1

Mobile App to Your Server

Seu app solicita ao seu próprio backend uma URL de checkout, autenticada com o token de sessão do usuário conectado.
2

Your Server to Dodo API

Seu backend cria uma checkout session com sua chave de API e retorna o checkout_url ao app.
Crie checkout sessions no seu servidor, nunca no app. Uma chave de API distribuída dentro do binário de um app pode ser extraída do bundle.
3

Mobile App Opens Checkout

Passe o checkout_url para DodoCheckout.start(...). O SDK o apresenta em SFSafariViewController e resolve com um resultado tipado quando o cliente conclui ou dispensa o checkout.
4

Dodo Payments to Your Server

Dodo Payments chama seu endpoint de webhook quando o pagamento é bem-sucedido ou a subscription é ativada.
5

Your Server Grants Access

Desbloqueie o conteúdo comprado a partir desse webhook, não do resultado recebido pelo app. O resultado do SDK é uma dica de UI, não uma prova de pagamento.

iOS Checkout SDK

Etapas de instalação e o contrato completo de start(...) para Swift.

Mobile Integration Guide

O fluxo de ponta a ponta, além do mesmo contrato para Android, React Native e Flutter.

Disponibilidade regional

Dodo Payments habilita fluxos alternativos de compras no app somente nas regiões da App Store onde a Apple permite explicitamente pagamentos externos ou onde um órgão regulador ou uma ordem judicial os determina.

Regiões compatíveis

Compatível na medida permitida pelas ordens judiciais vigentes e pelas diretrizes atualizadas da Apple.
  • Disponível conforme disposições específicas determinadas por ordem judicial
  • Sujeito à conformidade da Apple com os requisitos legais
  • Deve seguir as diretrizes de implementação da Apple
Compatível por meio dos Termos Alternativos da UE da Apple e do External Purchase Entitlement.
  • Habilitado por meio dos Termos Alternativos da UE da Apple
  • Requer aprovação do External Purchase Entitlement
  • Deve estar em conformidade com os requisitos do Digital Markets Act da UE
Compatível por meio do StoreKit External Purchase Entitlement para binários exclusivos da Coreia.
  • Disponível por meio do StoreKit External Purchase Entitlement
  • Requer um binário de app específico para a Coreia
  • Deve estar em conformidade com a legislação de telecomunicações da Coreia
Sempre analise e cumpra os entitlements específicos de cada região da Apple e os requisitos do App Store Connect antes de habilitar o Dodo Payments para qualquer storefront. O uso de fluxos de pagamento alternativos em regiões não compatíveis pode resultar na rejeição ou remoção do app.
Para alguns modelos de negócio — como serviços ou determinadas categorias de conteúdo — a Apple pode não exigir o uso de compras no app (IAP). O Dodo Payments também oferece suporte a esses modelos. Sempre verifique a classificação do seu app e as diretrizes mais recentes da Apple para determinar se o IAP é obrigatório no seu caso de uso.

Saiba mais

Para uma análise detalhada das políticas globais, dos precedentes legais e das abordagens estratégicas para contornar as taxas da App Store, consulte nosso guia completo:

Bypassing App Store & Play Store Fees: A Strategic and Legal Playbook

Saiba onde e como implementar legalmente fluxos de pagamento alternativos, com orientações regionais atualizadas e dicas de conformidade.
Última modificação em 31 de julho de 2026