This page documents a legacy SDK. Starting a new integration? Use the Yuno SDK. Already on a legacy SDK? Follow the migration guide.The new Yuno SDK (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) replaces the Full, Lite, Seamless, Render, Headless, and Secure Fields SDKs with one API across every platform. Legacy SDKs remain supported side by side during the transition and are scheduled for deprecation in 2027. Contact your Account Manager for migration planning.
onInstallmentSelected callback to keep your cart total in sync with the installment plan the shopper picks in the card form. The SDK notifies you when a default installment is pre-selected and every time the shopper changes the selection. It also notifies you when the plan is recalculated (for example, after a BIN change).
The callback is optional on all platforms: if you don’t register it, the SDK behavior is unchanged. Exceptions thrown inside your callback are caught by the SDK and never interrupt the payment flow.
Implementation
- Web
- iOS
- Android
Supply your own installment options with onGetInstallments
Available from Web SDK 1.6.7. Pass onGetInstallments inside the card options; the SDK calls it once it knows the card’s BIN and renders whatever you return in the installments selector. The callback has a 10-second timeout; if it times out, throws an error, or returns an empty array, undefined, or nothing, the SDK falls back to the installment plans configured in Yuno.The SDK calls
onGetInstallments again whenever the BIN or the amount changes, and ignores a stale response if a newer call has started. Options you return are reported to onInstallmentSelected with isMerchantInstallment: true.React to the shopper’s choice with onInstallmentSelected
Pass the callback inside the card options of startCheckout:null when the previous selection is no longer valid:When the selected option comes from your
onGetInstallments callback (isMerchantInstallment: true), installmentId, type, rate, and financialCosts are undefined, and the one-time token is created with installment: null.Firing semantics:- Fires with the current selection as soon as the plan renders and a default installment is pre-selected, so your total is correct from first paint.
- Fires on every selection the shopper makes.
- Re-fires the current selection when the available options change (for example, a BIN change recalculates the plan).
- Fires with
nullwhen previously notified options stop being available, for example when the shopper switches to a card without installments (from SDK1.10.3). It fires only if a selection was notified before, so forms that never had installments stay silent. - Works across all card flows, including secure fields and Click to Pay.