Pular para o conteúdo principal
Nesta página

Os SDKs da DEUNA renderizam experiências de pagamento dentro de aplicativos web e móveis. Escolha o guia da plataforma que corresponde ao aplicativo que você está distribuindo e, em seguida, use o método do produto suportado por esse SDK.

Escolha uma plataforma e fluxo#

CapacidadeRedeAndroidiOSReagir nativo
Widget de pagamentoinitPaymentWidgetinitPaymentWidgetinitPaymentWidgetinitPaymentWidget
Checkout completoNão expostoinitCheckoutinitCheckoutNão exposto
Armazenamento de Pagamentos e Pagamento com CliqueinitElementsinitElementsinitElementsinitElements
Continue com a ação 3DS ou outra ação pendenteinitNextActioninitNextActioninitNextActioninitNextAction
Experiência com vouchersinitVoucherWidgetinitVoucherWidgetinitVoucherinitVoucherWidget
Interface de carteira nativaApple Pay e Google PayGoogle PayApple PagueApple Pay e Google Pay
Apresentação modal e incorporadaSimSimSimSim

Fluxo de integração#

Diagrama de sequência
1Web or mobile app2Merchant backend3DEUNARequest a checkout sessionCreate order with private API keyReturn order tokenReturn order token onlyInitialize SDK with public API keyOpen the selected experienceSuccess, error, close, and lifecyclecallbacksSigned webhook with final state
Comerciante ou clienteDEUNA
  1. Crie o pedido em seu back-end com um privado Chave de API.
  2. Retorne apenas o token de pedido de curta duração para a aplicação.
  3. Inicialize o SDK com a chave API pública e o ambiente correspondentes.
  4. Abra a experiência apropriada e lide com as chamadas de retorno de sucesso, erro, fechamento e ciclo de vida.
  5. Use a chamada de retorno para atualizar a interface, mas use um webhook verificado como fonte de verdade para a conclusão do pedido.

Regras de ciclo de vida comuns#

  • Mantenha uma instância do SDK ativa durante toda a duração da experiência ativa.
  • Trate onSuccess como um sinal da interface do usuário; confirme o estado final do pagamento no seu backend.
  • Alça onError e onClosed separadamente. O fechamento de um widget por um cliente não é necessariamente uma falha no pagamento.
  • Libere o widget quando a tela ou o fluxo proprietário terminar. Use close() para um fluxo ativo e o mecanismo específico da plataforma para uma visualização incorporada.
  • Ligar initNextAction Use apenas com o token de pedido para um pedido que a DEUNA relata como exigindo outra ação.
  • Verifique a disponibilidade da carteira nativa antes de renderizar um botão Apple Pay ou Google Pay de propriedade do comerciante.

Código oficial#

Os repositórios mantidos são a fonte de verdade para versões de pacotes, versões de plataforma suportadas, notas de lançamento e exemplos executáveis.