yuno / tokenization
Merchant Guide

How tokenization works in Yuno.

Yuno replaces sensitive payment credentials with a token: a non-sensitive string your systems store and pass back at payment time. You never touch raw card data, and Yuno handles vaulting, retries, and routing across every connected processor.

Customer enters
4111 1111 1111 1111
PCI L1 vault
Yuno returns
ee78bc2a-63b4-45bb-bd28-3e6829ab1c3d

Tokens are non-convertible. Once issued, a token cannot be reverse-engineered back into the card number it represents.

The basics

One vault, every payment method

Yuno runs a fully managed, PCI DSS Level 1 tokenization service. Sensitive data is captured directly by Yuno's SDK and replaced with a token before it ever reaches your servers. That keeps card data out of your environment and reduces your compliance scope: most merchants integrating with the SDK qualify for the short self-assessment (SAQ A) instead of a full audit.

Tokenization is not limited to cards. The same token abstraction covers every method flowing through Yuno, so your integration stores one identifier regardless of how the customer pays.

Cards credit & debit Wallets Apple Pay, Google Pay, Click to Pay Local PIX, ACH, transfers APMs BNPL, vouchers
Token types

Three tokens, three jobs

Yuno issues three token types. Each maps to a different integration scenario. Color coding below is reused in the comparison table.

01 / SINGLE USE

One-time token

OTT

The SDK gathers everything needed for a payment and stores it in a token scoped to a single checkout session. Used once to create the payment, then it is dead. Generate a new one per session.

Created bySDK, per session
ValiditySingle transaction
Cross-processorNo
Needs enrollmentNo

Best for guest checkout and one-off payments with no saved method.

02 / PERSISTENT

Vaulted token

stored credential

Created when a payment method is enrolled and stored in Yuno's centralized vault against the customer. Reuse it to charge future payments without the customer re-entering details. Lives until the method is unenrolled.

Created byYuno on enrollment
ValidityUntil unenrolled
Cross-processorYes
Needs enrollmentYes

Best for returning customers, subscriptions, and one-click checkout.

03 / NETWORK

Network token

VTS / MDES

A digitized version of the card PAN issued by Visa, Mastercard, or Amex. When enabled, Yuno provisions network tokens for all enrolled cards and substitutes them at authorization. The network keeps them current.

Created byCard networks
ValidityAuto-renewed
Cross-processorYes
Needs enrollmentYes, automatic

Best for recurring billing and lifting authorization rates.

Lifecycle

From card entry to reusable credential

A single flow ties the three tokens together. The customer enters details once, you get an OTT to charge, and optionally promote it into a vaulted (and network) token for next time.

1

Create the customer

Yuno returns a customer id. Every payment and every stored token links back to it.

2

Open a checkout session

The session carries the amount and country, and scopes the token you are about to generate.

3

SDK captures the data and returns an OTT

Sensitive fields go straight to Yuno's vault. Your app receives a one-time token (token) plus safe display data: brand, last four (lfd), BIN (iin).

4

Create the payment with the OTT

Pass the token to Create Payment. Yuno routes it to the processor in your card route and runs 3DS or fraud checks as configured.

5

Promote to a vaulted token (optional)

Set vault_on_success: true on the request. If the payment succeeds, the method is enrolled and Yuno returns a vaulted_token in one step, no separate enrollment call.

6

Network tokenization applies automatically

When the feature is enabled, enrolled cards get a network token that Yuno substitutes at authorization and the network keeps updated through reissues.

Integration gotcha vault_on_success only vaults when the customer already exists. The payment must reference an existing Yuno customer via customer_payer.id and reach SUCCEEDED status. Passing customer data inline does not create the customer, so no vaulting occurs and no vaulted_token is returned.
At a glance

Token comparison

One-time token Vaulted token Network token
Created by SDK, per checkout session Yuno on enrollment Visa, Mastercard, Amex
Validity Single transaction Until unenrolled Auto-renewed by network
Primary use case Guest checkout, single payments Returning customers, subscriptions Recurring, higher auth rates
Works across processors No Yes Yes
Requires enrollment No Yes Yes, applied automatically
Key API field token vaulted_token network_token

Because vaulted and network tokens live in Yuno's central vault, switching or adding a processor needs no re-tokenization. The same stored credential works across every connected provider.

Beyond the token

Vault capabilities merchants get for free

Card fingerprinting

Every enrolled card gets a stable fingerprint derived from the PAN. It stays constant across enrollments, so you can detect duplicates and dedupe your vault without ever seeing the card number.

Card Account Updater

Yuno refreshes vaulted cards automatically when issuers change a number or expiry date. Your stored tokens stay valid through reissues, cutting declines from stale card data with no cardholder action.

Token migration

Moving to Yuno from another provider? Import existing tokenized cards straight into the vault. Customers keep saved methods and history, with no re-enrollment. Export is supported too if you ever move away.

Why it matters

What tokenization buys you

Smaller PCI scope. SDK capture keeps you on SAQ A. Portability. One credential, every processor. Higher approvals. Network tokens lift auth rates. Fewer declines. Auto-updated cards stay live.

The practical effect for an integration: store one identifier, never raw card data, and let Yuno handle recurring payments, fallbacks, and retries across processors without changing the customer experience.

Rule of thumb. Use an OTT to charge, set vault_on_success when you want to keep the method, and enable network tokens for any recurring or subscription flow.