SDK de DEUNA
Elija e integre el SDK de DEUNA para Web, iOS, Android o React Native.
En esta página
Los SDK de DEUNA renderizan las experiencias de pago dentro de las aplicaciones web y móviles. Elija la guía de la plataforma que corresponda a la aplicación que despliegue, y luego utilice el método del producto compatible con ese SDK.
Web SDKJavaScript y TypeScript para cualquier stack web.JavaScript · CDNReact NativeUna integración para aplicaciones iOS y Android.TypeScript · iOS + AndroidiOSSDK de Swift para aplicaciones iOS nativas.Swift · SPMAndroidSDK de Kotlin para aplicaciones Android nativas.Kotlin · Gradle
Elija una plataforma y flujo#
| Capacidad | Web | androide | iOS | Reaccionar nativo |
|---|---|---|---|---|
| Widget de pago | initPaymentWidget | initPaymentWidget | initPaymentWidget | initPaymentWidget |
| Finalizar compra | No expuesto | initCheckout | initCheckout | No expuesto |
| Almacén de pagos y Pago con un clic | initElements | initElements | initElements | initElements |
| Continúe con 3DS u otra acción pendiente | initNextAction | initNextAction | initNextAction | initNextAction |
| Experiencia de voucher | initVoucherWidget | initVoucherWidget | initVoucher | initVoucherWidget |
| Billetera nativa | Apple Pay y Google Pay | pago de google | de Apple Pay | Apple Pay y Google Pay |
| Modal y presentación integrada | Sí | Sí | Sí | Sí |
Flujo de integración#
Diagrama de secuencia
- Crea el pedido en tu backend con un privado Clave API.
- Devuelva únicamente el token de pedido de corta duración a la aplicación.
- Inicialice el SDK con la clave API pública y el entorno correspondientes.
- Abra la experiencia apropiada y maneje las llamadas de retorno de éxito, error, cierre y ciclo de vida.
- Utilice la llamada de retorno para actualizar la interfaz, pero utilice el estado final de pago de DEUNA como fuente de verdad para el cumplimiento.
Reglas de ciclo de vida comunes#
- Mantenga una instancia del SDK activa durante toda la duración de la experiencia activa.
- Trate
onSuccesscomo una señal de la interfaz de usuario; confirme el estado de pago final en su backend. - Manejar
onErroryonClosedpor separado. Cerrar un widget por parte del cliente no implica necesariamente un fallo de pago. - Liberar el widget cuando finalice la pantalla o el flujo correspondiente. Utilice
close()para un flujo activo y el mecanismo de eliminación específico de la plataforma para una vista integrada. - llamar
initNextActionsolo con el token de pedido para un pedido que DEUNA informa como requiriendo otra acción. - Verifique la disponibilidad de la billetera nativa antes de renderizar un botón de Apple Pay o Google Pay propiedad del comerciante.
Referencias comunes del SDK#
EventosCatálogos de eventos actuales y límites de análisis.Respuestas y llamadas de retornoÉxito, error, cierre, BIN, planes de financiación y ajuste de contratos.3DS y Próxima AcciónContinuar con una acción pendiente del cliente con el pedido original.Widget de cuponesPresentar instrucciones y confirmar el estado de pago asíncrono.División de pagos con tarjetaConfigurar y reconciliar un flujo de dos tarjetas compatible.Disponibilidad de billeteraDetectar Apple Pay o Google Pay antes de renderizar un botón.
código oficial#
Los repositorios mantenidos son la fuente de verdad para las versiones de paquetes, las versiones de plataforma compatibles, las notas de la versión y los ejemplos ejecutables.