Saltar al contenido principal
showView se invoca cuando el SDK tiene una vista lista para presentar: un formulario para recopilar datos del usuario o una vista de acción, como un código QR. Sobrescribe este controlador para insertar la vista en tu propio diseño en lugar de dejar que el SDK la presente a pantalla completa.
Las WebViews, por ejemplo los desafíos 3DS o las redirecciones que requieren algunos métodos de pago, siempre las presenta el SDK a pantalla completa. No pasan por showView, por lo que sobrescribirlo no cambia ese comportamiento. En iOS 3.x, el 3DS nativo aún no está disponible, así que todos los desafíos 3DS se ejecutan en una WebView.
showView está disponible en iOS, Android y React Native. En Web, el SDK muestra el formulario dentro del elemento que pasas como elementSelector, por lo que no hay ninguna vista que entregar. Para enviar ese formulario desde tu propio botón, consulta Web: enviar desde tu propio botón.

Comportamiento

Si no sobrescribes este controlador, el SDK presenta la vista a pantalla completa con su propio encabezado y su botón de envío. Cuando lo sobrescribes, el SDK entrega la vista a tu manejador junto con un objeto de control TransactionProcess. Colocas la vista donde quieras en tu diseño y llamas a process.onSubmit() para indicarle al SDK que el usuario activó el envío. Eres responsable de quitar la vista de tu diseño una vez que la transacción haya pasado de ese paso. El controlador puede invocarse más de una vez por transacción. El parámetro step indica a qué paso pertenece la vista. Por ejemplo, FORM para el formulario de captura de datos y ACTION para una vista de acción, como un código QR. Úsalo para diferenciar cómo insertas cada vista, si lo necesitas. En iOS, FORM contiene el formulario de pago o de inscripción, y ACTION contiene las pantallas que el SDK muestra para un método después del formulario: instrucciones de pago, como un QR o un código de pago, e ingreso de OTP. view es nil cuando el SDK no pudo construir una pantalla ACTION; en ese caso no hay nada que insertar y la transacción reporta su resultado a través de onStatus. Para devolver un paso al SDK desde tu sobrescritura, llama a SdkPayments.defaultShowView(view:process:step:). Por ejemplo, inserta el formulario y deja que el SDK presente las vistas de acción:
En React Native, llama a SdkPayments.defaultShowView(view, process, step) desde tu sobrescritura con los argumentos que recibió:
En React Native, los pasos que recibes siguen el SDK nativo subyacente: en iOS tanto las vistas FORM como ACTION llegan a showView; en Android solo llega FORM, porque el SDK de Android presenta las vistas de acción por sí mismo.

Firma

TransactionProcess

TransactionProcess es el objeto de control que el SDK pasa junto con la vista. Expone un único método:
Llama a process.onSubmit() cuando el usuario active el envío desde tu propia interfaz (por ejemplo, cuando toque tu botón de envío personalizado). El SDK valida el formulario y, si es válido, continúa la transacción. No necesitas gestionar aquí el éxito ni el fallo. El resultado del envío fluye a través de createPayment (si lo sobrescribes) y onStatus.

TransactionViewStep

TransactionViewStep indica a qué paso corresponde la vista.

Hilos de ejecución

En iOS y Android, showView se invoca en el hilo principal. Puedes actualizar la interfaz directamente desde este manejador. En React Native se ejecuta en el hilo de JavaScript: actualiza el estado de tu componente desde él.

Web: enviar desde tu propio botón

En Web, oculta el botón de pago del SDK con showPayButton: false y llama a transaction.submit() desde tu propio botón. Es el equivalente en Web de process.onSubmit().
submit() valida el formulario y, si es válido, continúa la transacción. Si el formulario no es válido, onStatus recibe INTERNAL_ERROR con el código FORM_INVALID. Ese estado no es final: el formulario sigue montado. El resultado de un envío válido fluye a través de createPayment (si lo sobrescribes) y onStatus, igual que cuando el usuario hace clic en el botón de pago del SDK.