Saltar al contenido principal
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.

Elija una plataforma y flujo#

CapacidadWebandroideiOSReaccionar nativo
Widget de PagoinitPaymentWidgetinitPaymentWidgetinitPaymentWidgetinitPaymentWidget
Finalizar compraNo expuestoinitCheckoutinitCheckoutNo expuesto
Almacén de pagos y Pago con un clicinitElementsinitElementsinitElementsinitElements
Continúe con 3DS u otra acción pendienteinitNextActioninitNextActioninitNextActioninitNextAction
Experiencia de voucherinitVoucherWidgetinitVoucherWidgetinitVoucherinitVoucherWidget
Billetera nativaApple Pay y Google Paypago de googlede Apple PayApple Pay y Google Pay
Modal y presentación integradaSíSíSíSí

Flujo de integración#

Diagrama de secuencia
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
Comercio o clienteDEUNA
  1. Crea el pedido en tu backend con un privado Clave API.
  2. Devuelva únicamente el token de pedido de corta duración a la aplicación.
  3. Inicialice el SDK con la clave API pública y el entorno correspondientes.
  4. Abra la experiencia apropiada y maneje las llamadas de retorno de éxito, error, cierre y ciclo de vida.
  5. Utilice la llamada de retorno para actualizar la interfaz, pero utilice un webhook verificado como fuente de verdad para la ejecución.

Reglas de ciclo de vida comunes#

  • Mantenga una instancia del SDK activa durante toda la duración de la experiencia activa.
  • Trate onSuccess como una señal de la interfaz de usuario; confirme el estado de pago final en su backend.
  • Manejar onError y onClosed por 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 initNextAction solo 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.

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.