> ## 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.

# Overview

> Yuno SDKs for iOS, Android, and Web.

<div className="ysdk-cta">
  <div className="ysdk-cta-text">
    <div className="ysdk-cta-title">Try our Yuno SDK now</div>

    <div className="ysdk-cta-sub">
      Configure a checkout and see it update live, no account or code
      required.
    </div>

    <a className="ysdk-cta-btn" href="https://sdk-webview.dev.y.uno/playground.html" target="_blank" rel="noopener noreferrer">Try it now →</a>
  </div>

  <div className="ysdk-hero">
    <div className="ysdk-mock">
      <div className="ysdk-hm-title">Payment methods</div>

      <div className="ysdk-hm-row ysdk-selected">
        <img src="https://mintcdn.com/yuno-3979e326/wcaoTPfNIXrvnpRG/images/yuno-sdk/pix.svg?fit=max&auto=format&n=wcaoTPfNIXrvnpRG&q=85&s=f1623b96e3812de4d05a91ff43c7a5d7" alt="" noZoom width="100" height="100" data-path="images/yuno-sdk/pix.svg" />

        <span>PIX</span>

        <span className="ysdk-hm-radio ysdk-selected" />
      </div>

      <div className="ysdk-hm-row">
        <img src="https://mintcdn.com/yuno-3979e326/wcaoTPfNIXrvnpRG/images/yuno-sdk/card.svg?fit=max&auto=format&n=wcaoTPfNIXrvnpRG&q=85&s=6eb2faee4e6eda8a8092294b95982221" alt="" noZoom width="100" height="100" data-path="images/yuno-sdk/card.svg" />

        <span>Card</span>

        <span className="ysdk-hm-radio" />
      </div>

      <div className="ysdk-hm-pay">Pay R\$150.00</div>
    </div>

    <div className="ysdk-chips">
      <span className="ysdk-chip ysdk-c1">initialize</span>
      <span className="ysdk-chip ysdk-c2">start()</span>
      <span className="ysdk-chip ysdk-c3 ysdk-ok">onStatus · SUCCEEDED ✓</span>
    </div>
  </div>
</div>

<Warning>
  **New Yuno SDK & Deprecation Notice:** This documentation covers the new **Yuno SDK** (Web v2.x, iOS v3.x, Android v3.x). Legacy SDKs (Full, Lite, Seamless, Render, Headless, and Secure Fields) remain supported side-by-side during the transition and are scheduled for deprecation in **2027**. Please contact your Account Manager for migration planning, timeline details, or support.
</Warning>

One integration, every platform. Yuno's SDKs for iOS, Android, and Web
share the same unified API, so what you build once works everywhere: the
same `Transaction`, the same `start()`, the same setup.

Initialize the SDK with your API key and start a `Transaction` for each
payment or enrollment. From there the SDK takes your shopper from picking
a method to a finished payment: forms, tokenization, 3DS, and the final
status, all handled for you. [How a transaction flows](/docs/yuno-sdk/how-a-transaction-flows) shows the sequence step by step.

<div className="ysdk-strip">
  <a className="ysdk-strip-item" href="https://github.com/yuno-payments/yuno-sdk-ios">
    <Icon icon="github" size={16} />

    <span className="ysdk-pi-name">iOS</span>
    <span className="ysdk-pi-lang">· Swift</span>
    <span className="ysdk-arrow">↗</span>
  </a>

  <a className="ysdk-strip-item" href="https://github.com/yuno-payments/yuno-sdk-android">
    <Icon icon="github" size={16} />

    <span className="ysdk-pi-name">Android</span>
    <span className="ysdk-pi-lang">· Kotlin</span>
    <span className="ysdk-arrow">↗</span>
  </a>

  <a className="ysdk-strip-item" href="https://github.com/yuno-payments/yuno-sdk-web">
    <Icon icon="github" size={16} />

    <span className="ysdk-pi-name">Web</span>
    <span className="ysdk-pi-lang">· JavaScript</span>
    <span className="ysdk-arrow">↗</span>
  </a>
</div>

## Start with the default checkout

The SDK ships a complete checkout: method list, forms, 3DS, and results.
Yuno renders and runs everything; you only listen for the result with
`onStatus`.

The form it renders is tuned so shoppers finish in seconds, with nothing
to configure. See
[A faster checkout](/docs/yuno-sdk/features/form-behavior) for more
examples of what speeds it up.

<Card title="Use our default checkout" icon="wand-magic-sparkles" href="/docs/yuno-sdk/checkout-preview">
  **Recommended.** Nothing to build and nothing to override.
  **See it live in the playground →**
</Card>

## Want more control?

Override just the piece you need. Everything else keeps working by
default:

<div className="ysdk-swb">
  <div className="ysdk-sw-row">
    <input type="checkbox" id="ysdk-sw-loading" className="ysdk-sw-input" />

    <div className="ysdk-sw-info">
      <span className="ysdk-sw-name">Loading UI</span>
      <span className="ysdk-sw-desc">The spinner shoppers see while the SDK works.</span>
    </div>

    <label className="ysdk-sw-toggle" htmlFor="ysdk-sw-loading">
      <span className="ysdk-sw-side ysdk-sw-off">Default</span>

      <span className="ysdk-sw-track" />

      <span className="ysdk-sw-side ysdk-sw-on">Yours</span>
    </label>

    <a className="ysdk-sw-link" href="/docs/yuno-sdk/controllers/show-loading">showLoading →</a>
  </div>

  <div className="ysdk-sw-row">
    <input type="checkbox" id="ysdk-sw-views" className="ysdk-sw-input" />

    <div className="ysdk-sw-info">
      <span className="ysdk-sw-name">Where forms render</span>
      <span className="ysdk-sw-desc">Embed the SDK's forms in your own screens. Mobile only.</span>
    </div>

    <label className="ysdk-sw-toggle" htmlFor="ysdk-sw-views">
      <span className="ysdk-sw-side ysdk-sw-off">Default</span>

      <span className="ysdk-sw-track" />

      <span className="ysdk-sw-side ysdk-sw-on">Yours</span>
    </label>

    <a className="ysdk-sw-link" href="/docs/yuno-sdk/controllers/show-view">showView →</a>
  </div>

  <div className="ysdk-sw-row">
    <input type="checkbox" id="ysdk-sw-form" className="ysdk-sw-input" />

    <div className="ysdk-sw-info">
      <span className="ysdk-sw-name">The form itself</span>
      <span className="ysdk-sw-desc">Collect the payment details in your own UI.</span>
    </div>

    <label className="ysdk-sw-toggle" htmlFor="ysdk-sw-form">
      <span className="ysdk-sw-side ysdk-sw-off">Default</span>

      <span className="ysdk-sw-track" />

      <span className="ysdk-sw-side ysdk-sw-on">Yours</span>
    </label>

    <a className="ysdk-sw-link" href="/docs/yuno-sdk/reference/objects-you-pass#transaction-data">transactionData →</a>
  </div>

  <div className="ysdk-sw-row">
    <input type="checkbox" id="ysdk-sw-payment" className="ysdk-sw-input" />

    <div className="ysdk-sw-info">
      <span className="ysdk-sw-name">Payment creation</span>
      <span className="ysdk-sw-desc">Your backend creates the payment instead of the SDK.</span>
    </div>

    <label className="ysdk-sw-toggle" htmlFor="ysdk-sw-payment">
      <span className="ysdk-sw-side ysdk-sw-off">Default</span>

      <span className="ysdk-sw-track" />

      <span className="ysdk-sw-side ysdk-sw-on">Yours</span>
    </label>

    <a className="ysdk-sw-link" href="/docs/yuno-sdk/controllers/create-payment">createPayment →</a>
  </div>
</div>

Not sure which pieces you need? [Where do I start?](/docs/yuno-sdk/where-do-i-start)
walks you through each decision, case by case.

## Choose a session type

The same `Transaction` class handles two flows:

* Pass a **`checkoutSession`** to process a payment.
* Pass a **`customerSession`** to enroll a payment method without
  charging.

See [Sessions](/docs/basic-concepts/sessions) for details.

## Backend requirements

The SDKs are client-side only. Your backend must:

1. Create checkout or customer sessions.
   * **Checkout session**: see [`POST /v1/checkout/sessions`](https://docs.y.uno/reference/checkout-sessions/create-checkout-session).
   * **Customer session**: see [`POST /v1/customers/sessions`](https://docs.y.uno/reference/customer-sessions-enrollment/create-customer-session).

See [Get Started](/docs/yuno-sdk/get-started) for the full backend
integration walkthrough.

## Migrating from a previous version

If you're currently using one of the legacy SDKs (Full, Lite, Seamless,
Render, Headless, Secure Fields), the new unified API replaces all of
them with a single `Transaction` class. Your existing integration will
continue to work, but new features and improvements ship in the
unified SDK.

See the [Migration guide](/docs/yuno-sdk/migration/overview) for a mapping from
legacy modes to the new API and step-by-step instructions for each
platform.

## Next steps

<CardGroup cols={2}>
  <Card title="Get started" href="/docs/yuno-sdk/get-started">
    Install, initialize, and process your first payment.
  </Card>

  <Card title="Where do I start?" href="/docs/yuno-sdk/where-do-i-start">
    Decide which parameters and controllers fit your integration.
  </Card>

  <Card title="Build with AI" href="/docs/yuno-sdk/build-with-ai">
    Install and integrate the SDK with your AI coding agent.
  </Card>

  <Card title="Controllers" href="/docs/yuno-sdk/controllers/overview">
    Control rendering, submission, and result handling.
  </Card>

  <Card title="Guides" href="/docs/yuno-sdk/features/payment-methods-list">
    Payment methods list, enrollment, deeplinks, styling.
  </Card>

  <Card title="Reference" href="/docs/yuno-sdk/reference/objects-you-pass#transaction-config">
    Config, payment method selection, transaction data, status.
  </Card>

  <Card title="Migration" href="/docs/yuno-sdk/migration/overview">
    Move from Lite, Full, Render, Headless, or Seamless to the unified SDK.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.