Saltar al contenido principal
Los controllers son la forma en que tu código recibe los eventos del SDK y, cuando lo necesitas, sobrescribe el comportamiento predeterminado. Implementa solo los que necesites.

Valores predeterminados

Implementa onStatus en todas las integraciones. Los demás son opcionales. Web no tiene showView: el SDK renderiza el formulario dentro de tu elementSelector. Para enviarlo desde tu propio botón, configura showPayButton: false y llama a transaction.submit().

Cómo conectar los controllers

  • Web. Cada evento es una función simple definida en la configuración de la transacción. onStatus, showLoading, createPayment y onChange son campos de nivel superior. onInstallmentSelected va dentro de card (card: { onInstallmentSelected }) y onShippingAddressChanged dentro de externalButtons (externalButtons: { onShippingAddressChanged }).
  • iOS, Android. Implementa TransactionController en el objeto que debe reaccionar a los eventos (tu view model, activity o una clase dedicada) y pásalo mediante el campo controller de TransactionConfig. Cada evento corresponde a un método de ese objeto. showView está disponible solo en móvil. En Android, onCardInfoChanged no es un método del controller: encadénalo en TransactionConfig (TransactionConfig(...).onCardInfoChanged { }).
  • React Native. Pasa un objeto simple como campo controller de TransactionConfig. Cada evento corresponde a un método de ese objeto, y los métodos que omitas conservan el comportamiento predeterminado del SDK. Para devolver una llamada al SDK desde un método que implementas, llama a SdkPayments.defaultShowView, SdkPayments.defaultShowLoading o SdkPayments.defaultCreatePayment con los argumentos que recibió.

Subprocesos

En iOS y Android, cada método del controller se invoca en el hilo principal. Puedes actualizar la interfaz directamente desde él. Mueve tú mismo fuera del hilo principal cualquier trabajo bloqueante (p. ej., las llamadas al backend dentro de createPayment). En React Native, los métodos del controller se ejecutan en el hilo de JavaScript.

Páginas por controller