Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

​
v2.15.0

April 10, 2026 Form Experience
  • Optional Delegate viewController
    delegate.viewController is now optional, simplifying integrations that do not need to provide a presenting controller. No changes required if you are already setting it.
  • Auto-advance
    The form now auto-advances to the next field when input is valid, reducing keystrokes during checkout. No configuration required.
  • Glass Keyboard Toolbar
    Added a keyboard toolbar with a glass effect for iOS 26. The toolbar appears automatically on iOS 26 and has no effect on earlier versions.
  • Expiration Date Single Source
    Removed redundant @Published expirationMonth and expirationYear properties. Expiration date now has a single canonical source, eliminating potential state inconsistencies.
Address & Contact Collection
  • Apple Pay Contact Fields
    The Apple Pay sheet now requests billing/shipping address, name, email, and phone based on the merchant’s required fields configuration. Driven by Dashboard settings — no code changes required.
  • Shipping Address Support
    Card and APM forms now support shipping address entry, including a billing/shipping toggle and field validation.
Enrollment & Validation Fixes
  • CVV Length for Enrolled Cards
    Fixed the CVV field character limit for enrolled cards: the field now enforces the correct length from securityCodeLength in the enrollment data. Previously the default 3-digit limit was always applied.
  • Validate IIN Session Header
    The validate IIN endpoint now sends customer_session instead of checkout_session during enrollment. This fixes a validation error that occurred when the session type was mismatched.

​
v2.13.0

January 30, 2026
  • Dynamic CVV Max Length
    The CVV field now enforces a dynamic maximum length based on the securityCodeLength value returned by the API. Previously the field always used a fixed 3-digit limit.
  • Card IIN Endpoint Migration
    Migrated card IIN lookups to the card-info endpoint with checkout session headers. Dynamic co-badged card brand selection is now supported. No integration changes required.
  • Platform Identification API
    Added a public setPlatform method and sub-platform header to all requests. Use setPlatform when integrating the SDK inside a wrapper framework.
  • Punto Pago Warning Banner
    Added a warning banner for the Punto Pago kiosk disclaimer. Activated automatically for eligible payment methods — no integration changes required.
  • Cardholder Name Max Length
    Increased the cardholder name field maximum length from 50 to 255 characters. No integration changes required.
  • Alphanumeric CNPJ Validation
    The CNPJ field now accepts alphanumeric input to support the updated Brazilian tax ID format. No integration changes required.
  • API Key Region Support
    Added region parsing from the API key. The SDK now routes requests to the correct regional endpoint automatically.

​
v2.12.3

January 20, 2026
  • Cardholder Name Now Optional
    The cardholder name field is now optional in card forms. Forms no longer block submission when this field is empty.

​
v2.12.2

January 8, 2026
  • Data Race in Payment Methods List
    Resolved a data race condition in the payment methods list loading function. This fix eliminates intermittent crashes on devices running concurrent background tasks.

​
v2.12.1

December 20, 2025
  • Apple Pay in Render Mode
    Fixed an Apple Pay initialization issue that prevented the payment sheet from appearing in render mode. Apple Pay now initializes correctly in all integration modes.

​
v2.12.0

December 5, 2025
  • cardFormType Removed from Initialization
    Removed cardFormType from SDK initialization. Card form type must now be configured in the Dashboard Checkout Builder. Update your integration before upgrading.
    Migration guide →

​
v2.11.1

November 20, 2025
  • Bug Fixes and Stability
    Various bug fixes and stability improvements. No API changes required.

​
v2.11.0

November 5, 2025
  • Podspec Configuration Updates
    Updated podspec configuration for improved CocoaPods compatibility. No API changes required.
  • Bug Fixes and Stability
    Various bug fixes and stability improvements. No API changes required.

​
v2.10.1

October 20, 2025
  • Updated Package Checksum
    Updated the Swift Package Manager checksum. Re-resolve your package dependencies after upgrading.

​
v2.10.0

October 5, 2025
  • Bug Fixes and Stability
    Various bug fixes and stability improvements. No API changes required.
  • Architecture Improvements
    Internal architecture refactoring for improved maintainability. No API changes required.

​
v2.9.0

September 10, 2025
  • Cards Expiring This Month Allowed
    Cards expiring in the current month and year are now accepted at checkout. Previously these cards were incorrectly rejected as expired.
  • Click to Pay Passkey Support
    Added Click to Pay passkey authentication support. Activated automatically for eligible transactions — no integration changes required.
  • PayPal Installments
    Added support for PayPal installments payment flow. Activated automatically when PayPal installments is configured for your account.
  • Dark Mode Support
    The SDK UI now adapts to the system dark mode setting. No configuration required; the SDK follows the device appearance automatically.

​
v2.8.1

August 20, 2025
  • Hide Debit Cards When Credit Only
    Debit cards are now hidden from the payment methods list when the merchant has enabled credit-only mode. No integration changes required.
  • Click to Pay Passkey for Render Mode
    Click to Pay passkey authentication is now supported in render mode. No integration changes required.
  • Traditional Chinese Date Format
    Added Traditional Chinese (zh-TW) date format for the MM/YY expiration field. Activated automatically based on the device locale.

​
v2.8.0

August 5, 2025
  • ACH Field Enrollment
    Added ACH bank account fields to the enrollment form. No integration changes required; the fields appear automatically when ACH enrollment is configured.
  • Settings Migration v1 to v2
    SDK settings have been migrated from the v1 schema to v2. Existing settings are migrated automatically on first launch after upgrading.
  • Secondary Background Color in Flexible Actions
    Flexible actions now support a secondary background color for improved UI customization. Configure via the YunoConfig.styles object.
  • Full Payment List Styling
    Added styling support to the full payment list view. Configure appearance via the YunoConfig.styles object.

​
v2.7.1

July 20, 2025
  • Click to Pay with Passkey
    Added Click to Pay authentication with passkey support. Activated automatically for eligible transactions — no integration changes required.
  • Pending Status Enrollment Notification
    The SDK now notifies the host app of pending status during enrollment when redirecting to a deeplink. Listen for the pending status in your enrollment callback.

​
v2.7.0

July 5, 2025
  • ClearSale Web Integration
    Integrated ClearSale fraud prevention via web integration. Activated automatically when ClearSale is configured for your account — no integration changes required.

​
v2.6.0

June 20, 2025
  • Navigation Toolbar for Keyboard
    Added a navigation toolbar that appears above the keyboard in payment and enrollment forms. The toolbar provides previous/next field navigation and a dismiss button.

​
v2.5.0

June 5, 2025
  • Recurring Apple Pay Support
    Added support for recurring Apple Pay subscriptions. The SDK handles the recurring payment sheet automatically when the checkout is configured for subscriptions.
  • Simplified Chinese and Traditional Chinese
    Added Simplified Chinese (zh-CN) and Traditional Chinese (zh-TW) language support. Activated automatically based on the device language setting.
  • iPad Screen Support
    The payment forms now adapt to iPad screen sizes with an optimized layout. No integration changes required.
  • OCR Card Scanning
    Added OCR card scanning to automatically populate card number, expiry, and cardholder name fields from the device camera. The button appears automatically in the card form when the device supports it.
  • ELO Card Icon
    Added the ELO brand icon to card form and payment list. Displayed automatically when an ELO card is detected.
  • Coinflow Chargeback Protection
    Integrated Coinflow chargeback protection. Activated automatically for eligible transactions — no integration changes required.

​
v2.4.2

May 28, 2025
  • Call Settings in Enrollment
    The SDK now calls the settings service during enrollment initialization. No integration changes required.
  • Credit-Only Enrollment Mode
    Added support for restricting enrollment to credit cards only. Configure via your Dashboard payment method settings.

​
v2.4.0

May 20, 2025
  • Deprecated startCheckout Method
    Removed the deprecated startCheckout(with: self) method. Use the async startCheckout API instead. See the migration guide for details.
  • getPaymentMethodView Async Replacement
    Replaced getPaymentMethodView with an async version that returns the view via a completion handler. Update call sites to use the new async signature.
  • startPaymentRender Replacement
    Replaced startPaymentRender with a new render flow method. Update call sites to use the new method name.
  • startPaymentLite Replacement
    Replaced startPaymentLite with an updated version. Update call sites to use the new method name.
  • Missing Apple Pay Values
    Added missing values in the /payment/complete service call for Apple Pay. This resolves payment failures that occurred for some Apple Pay transactions.
  • Nuvei 3DS Support
    Integrated Nuvei 3DS challenge handling. Activated automatically for eligible Nuvei transactions — no integration changes required.
  • Styling Object Update
    Updated the YunoConfig.styles object structure. Review the styling documentation if you customize SDK appearance.
  • Banner View Payment Action
    Added banner view support within the payment action view for flexible actions. No integration changes required.

​
v2.3.0

May 18, 2025
  • Text Component Identifier Separation
    Separated view block identifiers into specific text components for improved customization. Review custom text configurations if your integration overrides identifier labels.
  • NuPay Banner Text Weight
    NuPay banner messages are now displayed in bold for improved readability. No integration changes required.
  • CVV and Expiry Field Proportions
    Adjusted the width proportions of the CVV and expiration date fields in the card form for a more balanced layout. No integration changes required.
  • External Browser Redirect
    Redirects now open in the external browser when the backend flag is set, instead of always using an in-app web view. No integration changes required.

​
v2.2.2

May 16, 2025
  • Luhn Validation
    Added Luhn algorithm validation to the card number field. Cards with invalid Luhn checksums are now rejected before submission, reducing server-side errors.

​
v2.2.1

May 17, 2025
  • Bug Fixes and Stability
    Various bug fixes and stability improvements. No API changes required.

​
v2.2.0

May 16, 2025
  • PayPal Enrollment
    Added PayPal enrollment support. Users can now save their PayPal account during the enrollment flow.

​
v2.1.0

May 15, 2025
  • Color Codable Initializers Hidden
    Color Codable initializers are no longer part of the public API. If you were using these initializers directly, switch to the documented color configuration methods.
  • Sodexo Expiration Date Validation
    Added expiration date validation specific to Sodexo brand cards. No integration changes required.
  • Redirect Payment Action Support
    Added support for the redirect payment action type, enabling redirect-based APMs to operate through the flexible actions flow.

​
v2.0.0

May 15, 2025
  • NuPay Installments
    Added support for NuPay installments payment flow.
  • Flexible Actions Migration
    Migrated legacy Alternative Payment Methods (APMs) to the flexible actions architecture. Merchants using APMs should verify their payment flows after upgrading.
  • Mercado Pago 3DS
    Integrated Mercado Pago 3DS for enhanced fraud protection. Activated automatically for eligible transactions — no integration changes required.
  • Socket Connection Support
    Added WebSocket connection support based on a backend feature flag. No integration changes required.
  • Airwallex Anti-fraud Integration
    Integrated Airwallex anti-fraud detection. Activated automatically for eligible transactions — no integration changes required.
  • 3DS Unlimit Support
    Added 3DS challenge support for Unlimit payment method. Activated automatically — no integration changes required.

​
v1.25.0

April 1, 2025
  • Astropay Enrollment Support
    Added support for Astropay card enrollment. Users can now save their Astropay account during the enrollment flow.
  • Redirect-Type Enrollment
    Added support for redirect-type enrollment flows. The SDK now handles the redirect and returns the enrollment result to the host app.

​
v1.24.2

March 20, 2025
  • Loader Recursive Presentation
    Enhanced loader display with recursive view controller presentation for more reliable loading indicators in complex navigation stacks.

​
v1.24.1

March 15, 2025
  • Full Payment View Size Notification
    Added a notification for the full payment view size. Use this to adjust your container layout when the SDK view changes height.

​
v1.24.0

March 5, 2025
  • Mercado Pago Checkout Pro Browser
    Mercado Pago Checkout Pro now opens in an in-app browser instead of a web view. No integration changes required.
  • Preselected Payment Methods
    Added support for preselecting a payment method programmatically. Pass the payment method token when starting checkout to skip the payment list.
  • Full Payment List Migrated to SwiftUI
    The full payment list UI has been migrated to SwiftUI for improved performance and customization. No API changes required.
  • Flexible Actions Styling and QR Button
    Added styling support and a QR button to flexible actions. Configure via YunoConfig.styles.
  • 3DS Loading URL Support
    Added support for loading external URLs during 3DS challenges. No integration changes required.

​
v1.23.2

February 20, 2025
  • cancelByUser Notification for Enrollment
    The SDK now sends a cancelByUser notification when the user closes enrollment forms. Handle this event in your enrollment callback to update your UI accordingly.

​
v1.23.1

February 15, 2025
  • cancelByUser Notification for Apple Pay
    The SDK now sends a cancelByUser notification when the user closes the Apple Pay modal. Handle this event in your payment callback to update your UI accordingly.

​
v1.23.0

February 5, 2025
  • Generic Enrollment Forms and WebSocket
    Added support for generic enrollment forms and WebSocket connectivity. Tested with Bancolombia button integration.

​
v1.22.1

January 20, 2025
  • Embedded Web View Publisher
    Fixed an issue where embedded web views did not return anyPublisher directly. No integration changes required.

​
v1.22.0

January 5, 2025
  • Nationality Removed from Required Fields
    Nationality has been removed from the required fields list. Forms no longer request this field during enrollment.
  • OTP View in Flexible Actions
    Added an OTP (one-time password) input view within the flexible actions flow. Activated automatically for payment methods requiring OTP verification.
  • x-sdk-type Request Header
    Added x-sdk-type to all outbound request headers for improved platform telemetry. No integration changes required.
  • Enrolled Card Support in Dynamic SDK
    Added enrolled card handling to the dynamic SDK. Enrolled cards can now be used in dynamic payment flows.
  • Authorized Substatus Notification
    Added notification for the authorized payment substatus. Handle this event to take action when a payment is authorized but not yet captured.

​
v1.21.2

December 20, 2024
  • Enrollment Cancellables Memory Leak
    Added anyCancellables to YunoEnrollmentHeadlessImpl to prevent memory leaks in long-running enrollment sessions.

​
v1.21.1

December 15, 2024
  • Koin Dependency Removed
    Removed the Koin dependency from the SDK package. This reduces binary size and eliminates potential conflicts with apps that include Koin independently.

​
v1.21.0

December 5, 2024
  • Xendit Indoramart Payment Method
    Added support for Xendit - Indoramart payment method. Activated automatically when configured for your account.
  • MetricKit Performance Monitoring
    Integrated MetricKit and URLSessionTaskMetrics for performance monitoring and diagnostics. Metrics are collected automatically — no integration changes required.
  • Combined Payment and Enrollment Flow
    Added support for a combined payment and enrollment flow. Users can enroll a payment method and complete a payment in a single session.
  • Dynamic Actions Image Support
    Added IMAGE action type support to the dynamic actions framework. No integration changes required.

​
v1.20.0

November 20, 2024
  • Koin SDK Integration
    Integrated the Koin SDK package for Koin PIX Parcelado support. Add the Koin dependency to your project if you plan to use Koin payment methods.
  • Koin PIX Parcelado
    Added Koin PIX Parcelado installment payment support including socket-based status updates, OTP handling, and in-review status display.
  • Click to Pay Token Storage
    Added saving and sending of Click to Pay (C2P) tokens in user defaults. C2P is activated via a feature flag — no integration changes required.
  • Delayed Provider Response Screen
    Added a delayed provider response screen for payment methods that take additional time to confirm. No integration changes required.

​
v1.19.3

November 5, 2024
  • NuPay Redirect Payment
    Added NuPay redirect payment flow support. The SDK now handles the redirect and returns the payment result to the host app.

​
v1.19.2

October 28, 2024
  • Socket on Authorized Substatus
    The SDK now opens a socket connection when the payment substatus is authorized, enabling real-time status updates for authorized-but-pending payments.

​
v1.19.1

October 20, 2024
  • Document Required Field in Enrollment
    Added document number as a required field in enrollment forms when specified by the payment method configuration. No integration changes required.

​
v1.19.0

October 5, 2024
  • Inswitch Cash Payment
    Added support for Inswitch cash payment method. Activated automatically when configured for your account.
  • Inswitch Bank Transfer
    Added support for Inswitch bank transfer payment method. Activated automatically when configured for your account.
  • Xendit QRIS Payment Method
    Added support for Xendit QRIS payment method. Activated automatically when configured for your account.

​
v1.18.0

September 10, 2024
  • SDK Seamless Integration
    Added SDK seamless integration mode for a frictionless checkout experience. Contact your Yuno technical account manager to enable this feature.
  • RUT Validation and Masks
    Added Chilean RUT validation and input mask to document fields. Activated automatically for CLP transactions.
  • Dynamic SDK Cleanup
    Removed OptionalStateValue and YunoDynamicConnection class from the dynamic SDK. Internal refactoring — no API changes required.

​
v1.17.0

August 15, 2024
  • Copy Voucher in Enrollment Flow
    Added a copy button for voucher codes in the enrollment flow. Users can now copy the voucher code directly from the enrollment screen.
  • Dynamic SDK Conditional Dependencies
    Added dependencies for dynamic SDK condition evaluation. No integration changes required.
  • Dynamic SDK Text Field Restrictions
    Restricted allowed characters in dynamic SDK text fields for CARD and APM types to improve input validation. No integration changes required.

​
v1.16.0

July 20, 2024
  • FAC 3DS Action
    Added FAC 3DS action support. Activated automatically for eligible FAC transactions — no integration changes required.
  • Enrolled Card Form in Dynamic SDK
    Added enrolled card form support to the dynamic SDK. Enrolled cards can now be managed through dynamic SDK flows.
  • Step-by-Step Card Form in Dynamic SDK
    Implemented step-by-step card form in the dynamic SDK. The multi-step card entry flow is now available in dynamic integrations.
  • Backend-Driven Icons and View Names
    Icons and view names in the dynamic SDK are now fetched from the backend. No integration changes required.

​
v1.15.0

June 20, 2024
  • Step-by-Step Dynamic SDK
    Implemented step-by-step card form functionality in the dynamic SDK. The multi-step flow guides users through card entry one field at a time.
  • RUT Validation
    Added Chilean RUT document validation. Validation is applied automatically to RUT fields in payment and enrollment forms.
  • Dynamic SDK Analytics
    Added analytics event tracking for dynamic SDK flows. Events are sent automatically — no integration changes required.
  • Accessibility Identifiers for Automation
    Added accessibility identifiers to the sample app for UI automation testing. No production integration changes required.

​
v1.9.0

April 10, 2024
  • Loader and Service Timeout
    Added loader display during service calls and configurable service timeout. No integration changes required.
  • Analytics Event Flow
    Improved the analytics event flow for more accurate and complete event reporting. No integration changes required.

​
v1.6.2

February 15, 2024
  • Background Payment Status Query
    Added automatic payment status query when the app returns from background. This ensures the SDK has the latest payment state after the user completes a redirect flow.

​
v1.1.19

January 10, 2024
  • Mercado Pago Checkout Pro Caching
    Resolved a caching issue in Mercado Pago Checkout Pro that caused stale payment sessions to be reused. The SDK now always fetches a fresh session.
  • Daviplata Document Type Filtering
    Implemented document type filtering in the Daviplata enrollment form. Only supported document types are shown, reducing user errors.

​
v1.1.18

December 20, 2023
  • Loader Persistence Support
    Added support for persisting the loader between navigation steps. No integration changes required.

​
v1.1.17

December 5, 2023
  • Terms and Conditions Opening Bug
    Fixed a bug that prevented the terms and conditions link from opening correctly. The link now opens in the in-app browser as expected.
  • CheckboxColor in Yuno Appearance
    Added a checkboxColor field to the Yuno.Appearance object. Use this to customize the checkbox color in forms.
  • Payment Method Form Improvements
    Improved the payment method form layout and usability. No API changes required.

​
v1.1.16

November 20, 2023
  • Card Form Improvements
    Multiple improvements to the card form UI and validation. No API changes required.

​
v1.1.15

November 5, 2023
  • Required Fields in Card Form
    Added required field enforcement to the card form. Fields marked as required by the payment method configuration now block form submission when empty.

​
v1.1.14

October 20, 2023
  • Openpay Payment Method
    Added support for Openpay payment method. Activated automatically when configured for your account.
  • One-Step Card Form Customization
    Added customization options for the one-step card form. Configure appearance via the Yuno.Appearance object.

​
v1.1.13

October 5, 2023
  • New Payment Method Types
    Added support for additional payment method types. New methods are activated automatically when configured for your account.

​
v1.1.12

September 20, 2023
  • PagSeguro Checkout Support
    Added support for PagSeguro checkout payment method. Activated automatically when configured for your account.
  • UNLIMINT Checkout Support
    Added support for UNLIMINT checkout payment method. Activated automatically when configured for your account.

​
v1.1.11

September 5, 2023
  • Multistep Card Form Improvements
    Multiple improvements to the multistep card form flow and validation. No API changes required.

​
v1.1.9

August 10, 2023
  • Yuno Appearance Initialization Bug
    Fixed a bug where Yuno.Appearance object initialization could fail under certain configurations. The object now initializes correctly in all cases.
  • Dlocal Redirect Payment Method
    Added support for Dlocal redirect payment method. Activated automatically when configured for your account.
  • Khipu Payment Method
    Added support for Khipu payment method. Activated automatically when configured for your account.
  • Dlocal PSE Payment Method
    Added support for Dlocal PSE payment method. Activated automatically when configured for your account.
  • Multiple Step Card Form Improvements
    Multiple improvements to the multiple-step card form validation and navigation. No API changes required.

​
v1.1.8

July 20, 2023
  • Multiple Step Card Form Improvements
    Multiple improvements to the multiple-step card entry flow. No API changes required.

​
v1.1.7

July 5, 2023
  • Tarjeta Clave Payment Method
    Added support for Tarjeta Clave payment method. Activated automatically when configured for your account.
  • Kushki Payment Method
    Added support for Kushki payment method. Activated automatically when configured for your account.
  • Daviplata UX Improvements
    Improved the Daviplata payment form user experience. No API changes required.
  • Diners Card Form Improvements
    Improved the Diners card entry experience in the card form. No API changes required.

​
v1.1.3

May 15, 2023
  • Multi-Step Card Form Option
    Added multi-step card form as an alternative to the single-step form. Configure via cardFormType in SDK initialization.

​
v1.1.0

April 10, 2023
  • Swift Package Manager Support
    Added Swift Package Manager distribution. You can now integrate the SDK using either Swift Package Manager or CocoaPods.

​
v1.0.17

March 20, 2023
  • Card Form General Improvements
    General improvements to the card form including layout, validation, and accessibility. No API changes required.

​
v1.0.16

March 5, 2023
  • Card Form Wording Improvements
    Updated card form field labels and error messages for clarity. No API changes required.

​
v1.0.9

February 1, 2023
  • PIX and NuPay Async Payments
    Added async payment support for PIX and NuPay. The SDK now polls for status and notifies the host app when the payment completes.
  • Card Enrollment Support
    Added card enrollment to allow users to save cards for future payments.
  • Wibond Payment Method
    Added support for Wibond payment method. Activated automatically when configured for your account.
  • MercadoPago Wallet Support
    Added support for MercadoPago Wallet payment method. Activated automatically when configured for your account.