Skip to main content
This page walks you through every step needed to start accepting payments with Yuno on your VTEX store. The setup happens in two places. Your VTEX dashboard is where you register Yuno as a payment provider, install the Payment App, and activate payment methods. Your Yuno dashboard is where you configure the webhook that keeps order status in sync.

​
Before you start

Have the following ready:
  • A user with administrator access to your VTEX dashboard.
  • Your Yuno credentials, which you can find in your Yuno dashboard under Developers → API Credentials: Account ID, Public API Key, and Private Secret Key.
1

Configure Yuno as a payment provider

  1. In the VTEX dashboard, open the left-hand menu and go to Store Settings → Payment → Providers, then click New Provider at the top right.
New Provider in VTEX
  1. In the Select a provider dialog, type Yuno in the search box and select Yuno from the results.
Search for Yuno provider
  1. Fill in the provider configuration form and save. Once saved, the provider is registered, but no payment methods are active yet.
The Automatic Settlement field determines the timing of the capture for card and wallet payments.
Environments: The Yuno environment is determined by the prefix of your Public API Key: dev_, staging_, sandbox_, or prod_.
We suggest using Use behavior recommended by payment processor unless your business specifically requires capture after invoicing.
2

Install the Yuno Payment App

After saving the provider configuration, install the Yuno Payment App from your VTEX dashboard.
  1. In the VTEX dashboard, go to Apps → App Management.
  2. Search for Yuno and select the Yuno Payment App in the list of available apps and open its Settings.
Install Yuno Payment App
  1. Click Install to complete the setup.
Once installed, the Payment App takes care of rendering the Yuno checkout experience inside your VTEX checkout.
3

Activate payment methods

Now choose which payment methods you want to offer to your shoppers and route them through Yuno.
  1. In the VTEX dashboard, go to Store Settings → Payment → Settings → Payment Conditions. Click the + button to add a payment condition.
Add Payment Condition
  1. Select the payment method you want to activate (for example, Visa, Mastercard, Pix, Apple Pay, or any of the generic Yuno methods, such as Yuno Card or Yuno Wallet).
Select Payment Method
  1. In the Process with provider field, select the Yuno affiliation you configured in Step 1. Set the Status to Active and save.
Configure Payment Affiliation
Repeat for every method you want to offer. You can review the full list of available methods in the Overview page.
4

Configure the webhook in your Yuno dashboard

The webhook keeps your VTEX orders in sync with Yuno’s payment status updates.
  1. In the Yuno dashboard, open Developers → Webhooks and click Add webhook.
  2. Fill in the form:
    • Name: For example VTEX webhook.
    • Endpoint URL: https://{store_name}.myvtex.com/_v/yunopartnerbr.yuno/v4/webhook, replacing {store_name} with your VTEX account name.
    • x-api-key and x-secret: Enter any placeholder value (for example, VTEX).
  3. Select all events and click Add.

​
Advanced Scenarios

​
Multi-affiliation

A single VTEX account can be connected to more than one Yuno integration when you need to process different payment methods through different Yuno accounts. For example, you can assign one Yuno account to credit cards and a different one to wallets. To set this up, repeat Step 1 once per integration, giving each one a distinct Affiliation Name. Then, when activating payment methods, use the Process with affiliation field to choose which account should process it.

​
Multi-account

If your business runs multiple VTEX accounts (for example, a franchise model sharing the same Yuno credentials), use the Main Account fields in the provider configuration:
  • Main Account Name: The name of the main VTEX account.
  • Main Account App key and Main Account App token: Application credentials of that main account.
When these fields are set, the plugin reads catalog and order data from the main account instead of the current one.

​
Split orders (multiple sellers)

When a shopper’s cart contains products from different sellers or franchises, VTEX splits the purchase into multiple suborders and authorizes each one independently. The Yuno integration detects this and processes every suborder, so the entire order is paid, not just the first part. A single antifraud session is shared across all of them. This works automatically; no extra setup is required. If you want to control which antifraud providers receive the shared session, use the Antifraud Providers for Split Orders field in the provider configuration (see the field reference in Step 1). Valid values are RISKIFIED, CYBERSOURCE, SIGNIFYD, and CIELO_CYBERSOURCE_FRAUD; when left empty, it defaults to RISKIFIED + CYBERSOURCE.

​
Order modifications (changed order totals)

VTEX lets you change an order after checkout, when the final total turns out to be different from the amount that was authorized. This applies, for example, if you sell products by weight, where the exact total is only known once the order is picked and packed.
  • If the final total is the same or lower, VTEX captures only the final amount. No extra setup is required.
  • If the final total is higher, VTEX charges the difference as a separate, automatic charge. Since the shopper is no longer present and does not re-enter their card, Yuno charges the difference against the card they already used on the original order.
To enable automatic charges when an order total increases, configure the following in your provider settings before the orders you expect to modify are placed:
Order-total increases are supported for credit cards only (a VTEX restriction). The card is stored at the time of the original payment, so Vault Card for Order Modification and Create Customer must be enabled before the order is placed. Turning them on later does not apply to orders that already exist.
Franchises / multiple accounts: enable Vault Card for Order Modification and Create Customer on every affiliation you use (each franchise or sub-account), and set the Main Account fields as described under Multi-account.