yuno / stripe / connection settings
Merchant Configuration Guide

Configure your Stripe connection in Yuno

The 14 options you'll find when setting up a Stripe connection in the Yuno dashboard: what each one changes in the requests Yuno sends to Stripe, when to turn it on, and what to confirm with Stripe first

You enable
Radar Fraud Analysis ✓
Yuno adapts
POST /v1/payment_intents
Stripe receives
radar_options[session]
Overview

All 14 settings at a glance

Most settings are safe to leave off: the defaults give you a standard card flow. Turn one on when the situation in the last column applies to you. Every row links to the full explanation below

SettingWhat it controlsTurn it on when
Radar Fraud AnalysisForwards a browser Radar session to Stripe for full fraud scoringYou have Radar contracted directly with Stripe
Review Status DifferentiationSurfaces Radar manual reviews as a distinct payment statusYou hold captures until fraud review resolves
Embedded 3ds FlowLets shoppers complete 3DS challenges instead of being declinedYou want Stripe to handle 3DS challenges in your checkout
3DS Frictionless OnlyAttempts invisible 3DS only; challenges fail fast for re-routingStripe is one leg of a routing or cascade strategy
3DS CredentialsAcquirer data for an external 3DS provider (MPI)You authenticate through Netcetera, CyberSource or similar
Enable MIT & stored credentialsForwards CIT/MIT and card-on-file data to StripeYou charge saved cards or run subscriptions
Enable setup_future_usage for CITFlags the first payment of an agreement for off-session reuseLater charges may be routed to other providers
Eager tokenizationPre-tokenizes the card during checkout to speed up authorizationAuthorization latency matters and you accept the caveats
Enable on_behalf_ofMakes your connected account the merchant of recordYou are a Stripe Connect platform or marketplace
Controller parametersSpecial Connect mode: direct charges on connected accountsOnly under explicit guidance from Yuno
Send receipt_email parameterHas Stripe email its receipt to the shopperYou want Stripe-branded receipts sent automatically
Dynamic Metadata ConfigurationMaps your Yuno metadata keys to Stripe metadata keysYou need your own metadata visible in Stripe
Disable AFT information submissionSuppresses account-funding fields even if your API sends themYour Stripe account is not enabled for AFT processing
Transaction identification fromWhether your merchant_reference is stamped on Stripe paymentsYou reconcile in Stripe by your own order IDs
Fraud & risk

Two independent switches: signal in, verdicts out

One feeds data into Stripe Radar, the other surfaces Radar's verdicts back to you. They work independently and are often enabled together

Radar Fraud Analysis

checkboxreveals extra field

Enables Stripe Radar scoring with full browser signal. When checked, the Yuno SDK creates a Radar session in the shopper's browser using your Stripe publishable key, and Yuno forwards it on every payment as radar_options[session]. Radar's rules then score with complete device and behavioral data, exactly as on a native Stripe integration

Extra field
Publishable Key, required when Radar is selected. Used only in the shopper's browser to create the Radar session
Turn it on when
You have Radar contracted directly with Stripe and rules configured in your Stripe dashboard
Signal only

Yuno forwards the signal; the fraud analysis runs in your Stripe account. When unchecked, the session is never sent and Radar scores with much weaker data. To see Radar's manual-review verdicts in Yuno responses, also enable Review Status Differentiation below

Review Status Differentiation

checkboxoptional

By default, an authorization that Stripe Radar flags for manual review is reported by Yuno as a plain SUCCEEDED, indistinguishable from a clean approval. With this enabled, those payments return status SUCCEEDED with sub-status PENDING_IN_REVIEW, plus a provider_review_id to track the review in Stripe

Applies to
Manual-capture authorizations where Stripe's outcome is manual_review. Changes only how the response is mapped back, nothing in what is sent to Stripe
Turn it on when
You capture manually and want to hold the capture until Radar's review resolves
Before you enable

Your payment-status handling must accept the PENDING_IN_REVIEW sub-status. Systems that expect a plain SUCCEEDED will start seeing a new value

3D Secure

Three strategies, pick one per connection

Stripe-handled challenges, frictionless-or-fail-fast, or an external authentication provider. They are alternatives, not layers

Embedded 3ds Flow

checkboxreveals extra field

Lets Stripe run 3D Secure challenges inside your checkout instead of failing the payment. Yuno sends error_on_requires_action=false plus a return_url: when the issuer demands a challenge, the shopper completes it and the payment resolves after authentication

Extra field
Experience for the challenge: Redirect (default, shopper goes to the bank's page and back) or Embedded iframe (challenge renders in an iframe on your page)
With Radar off
Yuno also sends request_three_d_secure=automatic, letting Stripe decide when 3DS is needed
With Radar on
Your Radar rules decide when to trigger 3DS
When off
error_on_requires_action=true: any payment that would require a challenge is declined immediately
MIT exception

Merchant-initiated payments (subscriptions, rebills) never receive challenges regardless of this setting, since no shopper is present to complete one

3DS Frictionless Only

checkboxoptional

Attempts 3D Secure only when it can complete invisibly, through the frictionless flow or an exemption. Yuno sends request_three_d_secure=automatic together with error_on_requires_action=true: if the issuer insists on a challenge, the payment errors out immediately instead of showing one

Turn it on when
Stripe is one leg of a retry or cascade strategy. The instant decline lets your Yuno routing workflow send the payment to the next provider rather than interrupt the shopper
Precedence

Treat as mutually exclusive with Embedded 3ds Flow; if both are checked, Frictionless Only wins. It combines fine with Radar Fraud Analysis

3DS Credentials

checkboxoptionalreveals extra fields

Not Stripe's own 3DS. This holds the acquirer-side credentials needed when you authenticate through an external 3DS provider (an MPI such as Netcetera or CyberSource) and then process on Stripe. The MPI reads these values at authentication time, and the resulting proof (cryptogram, ECI, transaction ID) is attached to the Stripe payment as external 3DS data

Extra fields
Merchant name, merchant URL, merchant country code (3-letter ISO), MCC, acquirer country code, and one entry per card brand with acquirer BIN and acquirer merchant ID. Request these from your acquirer
Turn it on when
Your 3DS authentication runs outside Stripe. Leave unchecked for Stripe's native 3DS
Recurring & stored credentials

A master switch and its optimization

These two work as a pair: enable the first for any card-on-file or subscription use, add the second if rebills may be routed across providers

Enable MIT & stored credentials

checkboxoptional

The master switch for card-on-file and merchant-initiated payments on Stripe. When on, Yuno translates the stored_credentials object from your payment requests into Stripe's credential-on-file parameters

MIT rebills
Sent with off_session=true plus the network transaction ID from the original customer-initiated payment as mit_exemption, which lets Stripe process the rebill without shopper authentication
Other CIT/MIT
Your reason and usage map to Stripe's stored_credential_transaction_type, e.g. setup_off_session_recurring for a first subscription payment, stored_on_session for a returning card-on-file purchase
When off
stored_credentials in your API calls is ignored for this connection
Stripe account prerequisite

These features, in particular mit_exemption, must be enabled on your Stripe account beforehand, otherwise Stripe rejects the requests. Confirm with your Stripe contact before turning this on

Enable setup_future_usage for CIT

checkboxrequires MIT & stored credentials

On the first customer-present payment of a subscription or unscheduled card-on-file agreement, Yuno sends setup_future_usage=off_session, telling the issuer upfront that the credential will be reused later without the shopper present

What it buys you
Fewer authentication_required declines on later merchant-initiated charges, particularly when those charges are routed to a different provider than the one that processed the first payment
The trade-off
Can increase the 3DS challenge rate on that initial payment, since issuers scrutinize setup transactions more closely
Dependency

Only works if Enable MIT & stored credentials is also on; without it this setting has no effect

Checkout performance

Shaving seconds off authorization

Eager tokenization

checkboxoptional

A latency optimization. Yuno pre-creates the Stripe payment method while the shopper is still on the checkout page, between card capture and the moment they press Pay. The authorization then references the pre-created token instead of waiting for Stripe tokenization, which can otherwise add up to about three seconds

Safe by design
Strictly best-effort: 2.5 second budget, no retries, silent fallback to normal inline tokenization. It never blocks or fails a payment
Turn it on when
Authorization latency is a priority for your checkout experience
AVS & Radar caveat

If your fraud strategy leans heavily on AVS checks or Stripe Radar, check with your Yuno contact before enabling. A known limitation where pre-created payment methods carried incomplete billing details, weakening AVS and Radar signal, is being fixed as of July 2026

Stripe Connect

Platforms & marketplaces only

Only relevant if you operate a platform with connected accounts. Standard Stripe merchants should leave both unchecked

Enable on_behalf_of

checkboxoptional

Sets Stripe's on_behalf_of parameter, making the connected account (your sub-merchant) the merchant of record: their name on the shopper's card statement, and their country for fee and compliance purposes

Value source
The provider_recipient_id of the payment's purchase split, with a fallback to a metadata entry named on_behalf_of in your request
Turn it on when
You are a Stripe Connect platform and want statement and settlement attribution to sit with the sub-merchant
Attribution only

Independent from transfer_data, which controls where the funds move. When off, on_behalf_of is never sent, even if your requests include the values

Controller parameters

checkboxoptionalspecial purpose

A special-purpose Connect mode for specific connected-account architectures. It switches from destination charges to direct charges: each payment is executed directly on the sub-merchant's Stripe account (via the Stripe-Account header), the commission split becomes Stripe's application_fee_amount, and transfer_data / on_behalf_of are skipped entirely

Requirements
Every payment must carry the expected split data: a purchase split identifying the connected account, plus a commission split for platform fees. Otherwise the request is rejected
Leave unchecked

Enable only if Yuno has explicitly designed your Connect setup around this mode

Data sent to Stripe

What extra information travels with each payment

Send receipt_email parameter

checkboxcards only

When checked, card purchases include Stripe's receipt_email parameter, populated with the shopper's email from your Yuno payment request. Stripe then emails its own receipt to the shopper after a successful charge

Live mode behavior

In live mode Stripe sends this receipt regardless of the email settings in your Stripe dashboard. Enable only if you actually want Stripe-branded receipts going out. Card purchases only, not alternative payment methods

Dynamic Metadata Configuration

checkboxoptionalreveals extra fields

Controls which metadata from your Yuno payment requests is forwarded to Stripe, and under which names. You configure mapping rows of Merchant Key (the key you send in the Yuno API metadata object) to Provider Key (the key that appears on the payment in Stripe)

Behavior
Only mapped keys are forwarded; any metadata key without a mapping is dropped. Independent of this, Yuno always stamps metadata[transaction_code] on every Stripe payment
Turn it on when
Your team needs order or business context visible on payments inside the Stripe dashboard or in Stripe exports
Legacy retired

Stripe's legacy automatic metadata forwarding was retired in August 2025; this mapping is now the only way to get custom metadata into Stripe

Disable AFT information submission

checkboxoptional

AFT stands for Account Funding Transaction: payments that fund a wallet, prepaid account, or money transfer rather than purchase goods. If you send additional_data.order.account_funding (sender and beneficiary details) in the Yuno API, Yuno normally maps it into Stripe's sender_details and recipient_details fields (Visa requires both sides, Mastercard the recipient only)

Turn it on when
Your integration sends account-funding data globally, but this Stripe account is not enabled for AFT processing and would reject the extra fields
Default
Unchecked, meaning AFT data is forwarded whenever present. Checking the box suppresses the fields even though they arrive in your API requests

Transaction identification from

dropdowncards only

Options: Yuno (default) and Merchant Custom (merchant_reference). Despite the name, this does not change which identifier Stripe uses for the transaction; that is always the Stripe PaymentIntent. It controls which references are stamped on the payment's metadata in Stripe

Always
Yuno stamps metadata[transaction_code] on the Stripe payment
Merchant Custom
Additionally stamps metadata[merchant_reference] with the merchant_reference you sent, so your team can search and reconcile payments in Stripe by your own order IDs
Recommended
Yuno (default), unless you reconcile in Stripe by your own reference
Before you go live

Checklist