Fornecedores de pagamento do Unity IAP 5: Uma alternativa aos pagamentos da App Store e do Google Play.

O Unity In-App Purchasing (IAP) versão 5.4 e posteriores suportam os provedores de pagamento terceirizados Stripe e Coda Payments como alternativa à cobrança tradicional da loja de aplicativos. Os pagamentos diretos ao consumidor (D2C) no Unity permitem que os desenvolvedores ignorem a cobrança tradicional das lojas de aplicativos, direcionando os jogadores para processos de finalização de compra online.

A integração é gerenciada por meio do painel do Unity Gaming Services (UGS): os desenvolvedores conectam uma conta de provedor via OAuth, implantam um catálogo de produtos na nuvem ou o criam no painel da nuvem e direcionam os jogadores por meio de um checkout baseado na web que retorna ao jogo por meio de links diretos, onde é possível exibir uma mensagem de sucesso ou falha na compra.

O que você precisa saber sobre provedores de pagamento no Unity IAP 5

• Os provedores de pagamento terceirizados, Stripe e Coda Payments, estão disponíveis no Unity In-App Purchasing versão 5.4 e posteriores.
• Os provedores de pagamento são conectados no Painel de Controle do UGS em LiveOps > Compras no Aplicativo > Provedores de Pagamento, usando um fluxo de autorização OAuth com uma conta de provedor em ambiente de teste (Sandbox) ou em produção.
• O processo de finalização da compra ocorre em uma página da web externa, portanto, a identidade do jogador deve ser verificada com o pacote de Authentication da Unity ( Unity Player Accounts ou Login Anônimo) para que os itens comprados sejam entregues à conta correta.
• Os catálogos de produtos podem ser gerenciados localmente no Unity Editor ou implantados remotamente no Painel de Controle do UGS (LiveOps > Compras no Aplicativo > Catálogo). A implantação remota permite que as equipes de vendas e marketing alterem preços e executem promoções sem a necessidade de atualizar o aplicativo no lado do cliente.
• Os URLs de redirecionamento após a finalização da compra devem usar links diretos (por exemplo, mygame://checkout-success) em vez de URLs da web padrão, para que OS do dispositivo móvel feche o navegador e retorne o foco ao jogo automaticamente.
• As regras de roteamento no painel de provedores de pagamento da UGS podem direcionar transações para diferentes provedores por plataforma ou por país.
• Você pode configurar testes em ambiente de sandbox em Configurações do Projeto > Ambientes, criar um ambiente de desenvolvimento e, em seguida, conectar-se via OAuth a uma conta sandbox do Stripe ou Coda. Lá, você poderá testar o processo com números de cartão de crédito fictícios, sem envolver dinheiro real.
• Você pode começar com o exemplo Minimal Coded IAP 5 , importado da aba Exemplos do pacote Compras no Aplicativo no Gerenciador de Pacotes.

Como integrar um provedor de pagamentos com o Unity IAP 5

A integração segue sete etapas:

Criar contas. Vincule o projeto Unity a uma Organização Unity e a um ID de Projeto através da janela Serviços e crie contas de desenvolvedor no Stripe e/ou no Coda Payments (comece nos ambientes Sandbox deles).

Prepare o projeto. Instale ou atualize o recurso de Compras no Aplicativo (5.4 ou superior) no Gerenciador de Pacotes e importe o exemplo codificado de IAP 5. Instale o pacote de Authentication e adicione um provedor de identidade (Unity Player Accounts ou Login Anônimo) em Gerenciamento de Acesso > Authentication do Jogador no Painel do UGS .

Implante o catálogo de produtos. Configure os itens do catálogo (tipo de produto — Consumível, Não Consumível ou Assinatura — e preço base) no Editor e, em seguida, envie-os para a nuvem por meio de Serviços > Implantação. Verifique os SKUs em LiveOps > Compras no Aplicativo > Catálogo ou crie o catálogo diretamente no mesmo painel em LiveOps > Compras no Aplicativo > Catálogo.

Ambientes separados. Crie um ambiente de desenvolvimento em Configurações do Projeto > Serviços > Ambientes, selecione-o no Editor e corresponda à string de ambiente no script IAPService do exemplo (const string k_Environment = "development";). Combine o ambiente de desenvolvimento com uma conta de provedor sandbox e o ambiente de produção com uma conta real.

Conecte o provedor. No painel de controle do UGS , abra LiveOps > Compras no aplicativo > Provedores de pagamento, clique em Conectar no Stripe ou Coda, escolha Conta Sandbox e autorize o link por meio da caixa de diálogo OAuth do provedor.

Configure redirecionamentos com links diretos (deep linking). No cartão de configuração de pagamento, defina os URLs de sucesso para um esquema de URL personalizado, para que os jogadores retornem ao jogo após o pagamento, com o item entregue automaticamente. Os esquemas personalizados são declarados de acordo com a documentação de Deep Linking da Unity.

Teste e verifique. Reproduza a cena de exemplo codificada no Editor, acione uma compra, conclua o checkout do Stripe no ambiente de testes com um cartão fictício e confirme o retorno por link direto com um banner de confirmação de pedido. Verifique as transações no painel do provedor (Modo de Teste) e no UGS em LiveOps > Compras no Aplicativo > Registros, procurando por "Order Creator Success" seguido por "Order Status Update" ("Order Fulfilled Success").

Fluxo de compra IAP do Unity 5

Use o infográfico abaixo para visualizar todo o fluxo de compra do Unity IAP5, incluindo os novos recursos, lojas virtuais, catálogos e provedores de pagamento.

Faça o download do PDF em alta resolução aqui.

Armadilhas comuns ao adicionar provedores de pagamento

• Jogadores bloqueados após o pagamento: usar uma página da web simples como URL de sucesso deixa o jogador em um navegador externo após o pagamento, forçando-o a retornar ao jogo manualmente se, por exemplo, o jogador usou um navegador de computador. Use sempre um link direto para que OS os retorne automaticamente ao aplicativo ou processe as compras confirmadas ao buscar produtos (FetchProducts) quando você inicializa o jogo, conforme mostrado no infográfico.
• Ambiente inadequado: desenvolver em um ambiente de produção pode comprometer funcionalidades em produção. Mantenha um ambiente de desenvolvimento dedicado com uma conta de provedor de sandbox e certifique-se de que a string de ambiente no código corresponda à seleção do Editor.
• Identificação do jogador ausente: como o pagamento ocorre fora do aplicativo, a falha na Authentication do Unity significa que as compras não podem ser associadas de forma confiável à conta do jogador correta.
• Páginas de finalização de compra genéricas: um portal de pagamento sem marca quebra a continuidade visual. Os painéis de controle dos provedores (por exemplo, Stripe em Negócios > Marca) oferecem suporte a cores hexadecimais personalizadas, tipografia e logotipos de estúdio para combinar com a interface do usuário do jogo.

Saiba mais sobre como configurar provedores de pagamento para o Unity IAP 5 →