Skip to main content

Overview

Yuno offers multiple integration paths, each balancing development effort, customization, and PCI compliance scope. Choose the approach that best matches your technical requirements and business needs.

Choose Your Integration Path

SDK Integration

Best for: Most merchants. Pre-built UI components handle payment method selection, form rendering, and 3DS authentication. Minimal frontend code required.

Direct API

Best for: Merchants who need full UI control or server-to-server integrations. You build the frontend and call Yuno’s API directly.
Regardless of your choice, the server-side flow is the same: create a checkout session, process the payment, and handle webhooks.

Integration Comparison

FeatureFull CheckoutLite CheckoutSecure FieldsDirect API
UI ControlYuno-managedPartialFullFull
Development EffortLowMediumMedium-HighHigh
PCI ScopeSAQ-ASAQ-ASAQ-ASAQ-D (Level 1)
Payment Method SelectionAutomaticDeveloper-chosenCard onlyDeveloper-managed
3DS HandlingAutomaticSDK-assistedSDK-assistedManual
CustomizationTheme/colorsTheme + layoutFull CSS controlN/A (your UI)
Mobile SDK SupportYesYesYesN/A
Best ForQuick launchBranded checkoutCustom card formsBackend systems

Integration Options

Full Checkout

Fastest path to production. Yuno renders a complete checkout UI with all enabled payment methods. Ideal for merchants who want a turnkey solution with minimal frontend work.

Lite Checkout

Balanced approach. Embed a Yuno payment form in your existing checkout page. You control the page layout while Yuno handles the payment form and PCI compliance.

Secure Fields

Maximum UI control. Embed individual card input fields (number, expiry, CVV) as secure iframes. Build a fully custom card form while maintaining SAQ-A compliance.

Direct API

Full server-side control. Integrate directly with the Yuno REST API for complete flexibility. Requires PCI DSS Level 1 certification for handling raw card data.

Decision Guide

1

Do you need to handle raw card data server-side?

Yes — Use Direct API. You must be PCI DSS Level 1 certified.No — Continue to the next question.
2

Do you need full control over card input field design?

Yes — Use Secure Fields. You get full CSS control over individual inputs.No — Continue to the next question.
3

Do you want to embed the payment form in your page?

Yes — Use Lite Checkout. The form integrates into your checkout page.No — Use Full Checkout for a complete hosted experience.

PCI Compliance

Your PCI compliance obligations differ significantly based on your integration choice. Direct API requires PCI DSS Level 1 (the most stringent), while SDK-based integrations qualify for SAQ-A (the simplest self-assessment).
IntegrationPCI LevelWhat It Means
Full CheckoutSAQ-ACard data never touches your servers or pages
Lite CheckoutSAQ-ACard data handled in Yuno-managed iframes
Secure FieldsSAQ-AIndividual fields rendered in secure iframes
Direct APISAQ-D Level 1You handle, transmit, and store card data

Next Steps

After choosing your integration, follow the corresponding guide to get started. All integrations share the same server-side payment creation and webhook handling.