onInstallmentSelected se invoca cuando el comprador elige una opción de cuotas en el formulario de tarjeta, incluida la selección automática de la primera opción cuando se carga la lista. Es informativo: la selección viaja con el pago de todos modos, por lo que sobrescribirlo es opcional. Úsalo para reflejar la financiación elegida en tu propia interfaz (por ejemplo, para actualizar el resumen del pedido).
Disponible en Web, iOS, Android y React Native. En Web, defínelo dentro del campo card de la configuración de la transacción. El SDK lo llama desde cada formulario de tarjeta que muestra.
Qué recibes
amount es null (undefined en Web) cuando el backend no proporcionó montos para la opción. Cuando los planes provienen de card.onGetInstallments (isMerchantInstallment: true), installmentId, type, rate y financialCosts son undefined, y el token de un solo uso se crea con installment: null.
La entrega de null
El controlador recibe null (nil en iOS) cuando una selección informada anteriormente deja de ser válida: las cuotas disponibles cambiaron, normalmente porque el comprador editó el número de tarjeta y la nueva tarjeta no tiene planes de cuotas. Trátalo como “ya no hay ninguna cuota seleccionada”. Se dispara como máximo una vez por invalidación; una nueva selección lo vuelve a habilitar.
Firma
- Web
- iOS
- Android
- React Native
Relacionado
- Escuchar eventos. Los demás controladores informativos.
onStatus. El resultado final de la transacción.- Resumen de los controladores. Cómo se conectan los controladores en cada plataforma.