Transaction. Lo que cambia entre las
integraciones es qué parámetros pasas y qué controladores
sobrescribes. Cada decisión es independiente. Combínalas libremente.Esta página recorre las decisiones que tomarás y te lleva a la
documentación relevante para cada una.Activa el interruptor en cada paso y el código de la derecha se arma solo para tu plataforma. Cada bloque que usa el código también está escrito debajo de su paso, así que puedes componerlo a mano: parte de la base y luego agrega el bloque de cada paso en el que elegiste la respuesta distinta de la predeterminada. Un bloque de configuración reemplaza el TransactionConfig, un bloque de método de pago reemplaza el PaymentMethodSelected, una línea de indicador va dentro de TransactionConfig, y un bloque de controlador va dentro de tu clase de controlador, o dentro de las opciones de la transacción en Web.Base
El SDK hace todo: muestra el formulario, crea el pago, gestiona 3DS e informa el resultado aonStatus. Crea la sesión de checkout con workflow: "SDK_SEAMLESS" para esta base.Código base
Código base
- iOS
- Android
- Web
- React Native
- ¿Estás procesando un pago o guardando un método de pago?
Esta decisión afecta qué tipo de sesión creas en tu backend y
pasas al SDK.- Para procesar un pago, crea una sesión de checkout y pásala a
TransactionConfigcomocheckoutSession. Usa esto cuando quieras cobrarle al cliente. - Para guardar un método de pago sin cobrar, crea una sesión de
cliente y pásala como
customerSession. Usa esto cuando quieras inscribir una tarjeta u otro método para uso futuro. - Para pagar e inscribir al mismo tiempo, pasa solo
checkoutSession:- Tarjetas. Activa el indicador “guardar tarjeta al pagar” en tu Checkout Builder. El SDK cobra al cliente y guarda la tarjeta para uso futuro.
- Otros métodos de pago. Asegúrate de que la variante inscribible del
método esté agregada en tus conexiones. Cuando lo está, el SDK
gestiona el pago y la inscripción juntos a partir de la sesión de
checkout únicamente. En Web, pasa también
savePaymentMethodEnabled: trueenTransactionConfigy crea la sesión de checkout con uncustomer_id. Entonces el SDK agrega una opción de guardado al formulario.
checkoutSession y customerSession al mismo
tiempo.Consulta Sesiones e
Inscripción.Usa esta configuración para inscribir en lugar de cobrar
Usa esta configuración para inscribir en lugar de cobrar
- iOS
- Android
- Web
- React Native
- ¿Quién crea el pago?
Esta decisión afecta si sobrescribes createPayment.- Predeterminado. El SDK crea el pago. Después de la tokenización, el
SDK llama a Yuno para crear el pago, gestiona 3DS si es necesario y
emite el estado final a
onStatus. No sobrescribes nada. Crea la sesión de checkout conworkflow: "SDK_SEAMLESS"para que el SDK pueda gestionar la creación del pago de principio a fin. Consulta el campoworkflow. - Tú creas el pago. Sobrescribe
createPaymentpara recibir el token. Envíalo a tu backend, crea el pago llamando aPOST /v1/paymentsy resuelve la Promise/Task. Entonces el SDK consulta el estado y continúa el flujo.
customerSession),
createPayment no se invoca con datos de pago. No hay
ningún pago que crear. Sobrescribir este controlador no tiene efecto en
la inscripción.createPayment.Agrega este bloque a tu controlador cuando crees el pago
Agrega este bloque a tu controlador cuando crees el pago
- iOS
- Android
- Web
- React Native
- ¿Quién recopila los datos de pago?
Esta decisión afecta si pasas transactionData en
PaymentMethodSelected.- Predeterminado. El SDK muestra los formularios. El SDK presenta el formulario adecuado (formulario de tarjeta, formulario de datos de APM, etc.) y recopila los datos que ingresa el usuario.
- Tú proporcionas los datos. Pasa
transactionData(dataen Web) enPaymentMethodSelectedcon los valores ya recopilados (por ejemplo, datos de tarjeta capturados por tu propia interfaz). El SDK omite los formularios y tokeniza directamente.
PaymentMethodSelected
y TransactionData.Usa este PaymentMethodSelected cuando hayas recopilado los datos tú mismo
Usa este PaymentMethodSelected cuando hayas recopilado los datos tú mismo
- iOS
- Android
- Web
- React Native
- ¿Quién controla la interfaz del formulario? (iOS, Android, React Native)
Esta decisión afecta si sobrescribes showView.- Predeterminado. El SDK presenta el formulario a pantalla completa. El SDK muestra el formulario con su propio encabezado y su propio botón de envío.
- Tú incrustas el formulario. Sobrescribe
showViewpara recibir la vista del formulario y un controlTransactionProcess. Coloca la vista en tu propio diseño y llama aprocess.onSubmit()para controlar el envío.
En Web: tu propio botón de pago en lugar de showView
En Web el SDK renderiza el formulario dentro del elemento que pasas como elementSelector, por lo que el formulario ya está en tu diseño. Para usar tu propio botón de envío, define showPayButton: false en TransactionConfig y llama a transaction.submit() desde tu botón después de que start() se haya resuelto. Si el formulario está incompleto, submit() informa INTERNAL_ERROR con el código FORM_INVALID a través de onStatus y mantiene el formulario montado. submit() no está disponible para las transacciones de inscripción.Consulta showView.Agrega este bloque a tu controlador cuando incrustes el formulario
Agrega este bloque a tu controlador cuando incrustes el formulario
- iOS
- Android
- React Native
- ¿Quién muestra el indicador de carga?
Esta decisión afecta si sobrescribes showLoading.- Predeterminado. El SDK muestra su propio indicador de carga durante la tokenización, la creación del pago y la consulta del estado.
- Tú muestras tu propio indicador de carga. Sobrescribe
showLoadingpara recibirisLoading: true | falsey renderizar tu propia interfaz.
showLoading.Agrega este bloque a tu controlador cuando muestres tu propio indicador de carga
Agrega este bloque a tu controlador cuando muestres tu propio indicador de carga
- iOS
- Android
- Web
- React Native
- ¿Debe el SDK mostrar una pantalla de resultado después de la transacción?
Define el indicador showStatusScreen
en TransactionConfig.Agrega esta línea a TransactionConfig para mostrar la pantalla de resultado del SDK
Agrega esta línea a TransactionConfig para mostrar la pantalla de resultado del SDK
- iOS
- Android
- Web
- React Native
Implementa siempre onStatus
Sin importar las decisiones que tomes arriba, siempre debes
implementar onStatus. Es la única forma de saber cómo terminó la
transacción. Consulta onStatus para saber cuándo
se ejecuta y qué estados informa en cada plataforma, y
Status para ver el
objeto que recibes.Referencia rápida
Próximos pasos
- Primeros pasos. Instala el SDK y ejecuta tu primera transacción.
- Configuración. Referencia completa de
TransactionConfig,PaymentMethodSelectedyTransactionData. - Controladores. Referencia completa de cada controlador y de lo que cambia cuando lo sobrescribes.