Configure Yuno as Provider
To offer more payment methods to your clients using Yuno as the provider, you need to follow the steps below to connect your VTEX account to Yuno and configure the payment methods you want to offer.
-
Log into your VTEX store account.
-
In the VTEX Admin dashboard, navigate to Store Settings > Providers and click New Provider.

- Search for Yuno on the dialog and select the Yuno option on the results.

- Fill out the form with the required information. Following, you will find a description for each field you need to fill:
Field | Description |
---|---|
App key | VTEX application keys. For additional information on accessing it, see Generating internal application keys. |
App Token | VTEX application token, which you find when Generating internal application keys. |
Name | Connection name. You can use Yuno. |
Enable Test Mode | It enables you to decide whether to use the Production or Sandbox environments. While you are testing, Yuno recommends you enable test mode. |
Automatic Settlement | Select the option Use behavior recommended by payment processor. |
Affiliation Name | This name should be equal to the previously provided for connection Name. |
Account_ID | The Yuno account_id . You can find this information in the Yuno dashboard. For additional information, see Developers (Credentials). |
Public API Key | The Yuno public-api-key . You can find this information in the Yuno dashboard. For additional information, see Developers (Credentials). |
Private Secret Key | The Yuno private-secret-key . You can find this information in the Yuno dashboard. For additional information, see Developers (Credentials). |
Test Mode Warning
VTEX recommends you to not enable the test mode in production environments, since the test payment options will be available to customers in your store.
- After filling in all fields, click Save.
- Navigate to Store Settings > Settings and click the + button (green button at the top right corner) to add a new payment option.

- Select the payment method you want to provide for your customer. You need to configure the provider for each card brand you want to make available for your customer.

- After you select the payment method, a new dialog is displayed where you need to configure the payment provider:
- At the Process with provider, select Yuno.
- Add special conditions if necessary. For additional information regarding configuring the special conditions, access Configuring payment special conditions. For further information on configuring payment conditions considering installments with or without interest, check the VTEX page.
- Click Save.
- Change the Status to Active.

Adding Multiple Payment Methods
If you want to add more than one payment method to offer to your clients, Visa and Mastercard for example, you need to repeat steps 7 and 8 two times, one for Visa and the other for Mastercard.
- As the last step, you have to configure the Webhook URL to receive the updates from the payments.
- Access the Yuno Dashboard and select Developers.
- Select the Webhooks tab.
- Click add webhook. The webhook form will show up, where you should provide the following information:
- Name: Define a name for the VTEX webhook.
- Endpoint URL: You should inform the following URL https://store_name/_v/yunopartnerbr.yuno/v4/webhook.
- x-api-key and x-secret: You can set any information here. For example, you can add VTEX for both fields.
- For Trigger on, check all events that should notify you through the webhooks. Yuno recommends checking all options.
- Click Add.

PIX payment expiration management
When configuring PIX payments with VTEX, Yuno provides automatic expiration handling to prevent order reconciliation issues:
- Custom expiration tracking: Yuno internally monitors PIX payment expiration dates without relying solely on provider webhooks
- Proactive verification: Before expiration, Yuno verifies with the provider if the payment was completed
- Automatic order cancellation: When PIX payments expire unpaid, Yuno immediately notifies VTEX via webhook, allowing automatic order cancellation
- Reconciliation consistency: This ensures payment statuses remain synchronized between VTEX, Yuno, and the payment provider
This feature is particularly valuable for merchants who set custom expiration dates on PIX payments, as it prevents orphaned orders and inventory discrepancies. It specifically addresses the common issue where VTEX continues attempting to authorize expired PIX payments for extended periods (up to 24 retries), creating status mismatches across systems.
Important: This enhanced expiration handling only works when you configure a custom
expiration_date
during PIX payment creation, not for default provider expiration times.
After completing the steps above, your clients can access a new payment method at checkout. If you configure Visa, for example, when your customers arrive at the checkout phase and select credit card as the payment method, the Yuno checkout will gather all the information required for fraud screening and 3DS services in the background while using the VTEX credit card form.

Once you start receiving payments in VTEX with Yuno, you will be able to see all the information related to the transactions in your Yuno dashboard as a regular payment.
-
As additional info in the payment detail, particularly inside the metadata struct, you will also be able to identify the VTEX account related to the payment creation.
"metadata": [ { "key": "vtex_account", "value": "[your_vtex_subaccount]" } ]
Customizations
If you want to add or change certain UX aspects of the checkout, VTEX lets the merchants modify a few things:
- Checkout Page customizations
- Change Payment Method names in Checkout.
Updated 18 days ago