SDKs DEUNA
Escolha e integre o SDK da DEUNA para Web, iOS, Android ou React Native.
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.
Web SDKJavaScript e TypeScript para qualquer stack web.JavaScript · CDNReact NativeUma integração para aplicativos iOS e Android.TypeScript · iOS + AndroidiOSSDK Swift para aplicativos iOS nativos.Swift · SPMAndroidSDK Kotlin para aplicativos Android nativos.Kotlin · Gradle
Escolha uma plataforma e fluxo#
| Capacidade | Rede | Android | iOS | Reagir nativo |
|---|---|---|---|---|
| Widget de pagamento | initPaymentWidget | initPaymentWidget | initPaymentWidget | initPaymentWidget |
| Checkout completo | Não exposto | initCheckout | initCheckout | Não exposto |
| Armazenamento de Pagamentos e Pagamento com Clique | initElements | initElements | initElements | initElements |
| Continue com a ação 3DS ou outra ação pendente | initNextAction | initNextAction | initNextAction | initNextAction |
| Experiência com vouchers | initVoucherWidget | initVoucherWidget | initVoucher | initVoucherWidget |
| Interface de carteira nativa | Apple Pay e Google Pay | Google Pay | Apple Pague | Apple Pay e Google Pay |
| Apresentação modal e incorporada | Sim | Sim | Sim | Sim |
Fluxo de integração#
Diagrama de sequência
- Crie o pedido em seu back-end com um privado Chave de API.
- Retorne apenas o token de pedido de curta duração para a aplicação.
- Inicialize o SDK com a chave API pública e o ambiente correspondentes.
- Abra a experiência apropriada e lide com as chamadas de retorno de sucesso, erro, fechamento e ciclo de vida.
- Utilize o callback para atualizar a interface, mas utilize o status de pagamento final da DEUNA como fonte de verdade para o fulfillment.
Regras de ciclo de vida comuns#
- Mantenha uma instância do SDK ativa durante toda a duração da experiência ativa.
- Trate
onSuccesscomo um sinal da interface do usuário; confirme o estado final do pagamento no seu backend. - Alça
onErroreonClosedseparadamente. 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
initNextActionUse 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.
Referências do SDK compartilhado#
EventosCatálogos de eventos e limites de análise atuais.Respostas e callbacksSucesso, erro, cancelamento, BIN, parcelamento e ajuste de contratos.3DS e Próxima AçãoContinue uma ação pendente do cliente com o pedido original.Widget de voucherApresente instruções e confirme o estado de pagamento assíncrono.Dividir pagamentos com cartãoConfigure e valide um fluxo de pagamento com duas cartões suportado.Disponibilidade da carteira digitalDetecte Apple Pay ou Google Pay antes de exibir um botão.
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.