VTEX Integration Guide

September 16, 2025

Accept payments for your products and services with the Kushki’s plugin in your VTEX store.

Overview

With the Kushki payment plugin in VTEX, you can accept credit cards, debit cards, and bank transfers directly in your online store. The integration is fast and flexible, and activation is completed in just a few steps.

Steps to enable the plugin

1. Activate the payment provider in VTEX 1.1. In VTEX, go to Store Settings > Providers. 1.2. Click on New Provider and select Yuno*. 1.3. Complete all required fields (App Key, App Token, and integration credentials).

   Note: The Kushki team will provide you with these credentials during the integration process.

   1.4. Next, go to Store Settings > Payment Conditions and configure each payment method you want to enable:

   • Click on + to create a new condition.
   • Search for the payment method:
     • For transfers, select the one available for your country (example: PSE in Colombia or SPEI in Mexico).
     • For cards, select the card brand you will accept payments with (example: Visa, MasterCard, or American Express).
   • Activate the payment condition using the Status toggle.
   • In Process with affiliation, select Yuno.
   • (Optional) Configure special conditions like expiration date, commercial policies, or installments for cards.
   • Click on Save.

   Repeat this procedure individually for each payment method you want to enable (for example, each card brand and each bank transfer). 👉 For more information, see the official Yuno documentation for VTEX. *Yuno is our technological partner for this integration.

2. Configure Webhooks To receive notifications about the status of transactions, you must configure webhooks in both VTEX and Kushki:

   • In VTEX, define the Webhook URL with the format: https://store_name.myvtex.com/_v/yunopartnerbr.yuno/v4/webhook

   • Set values in the x-api-key and x-secret fields. You can use a simple value, for example: VTEX.

   • Activate all available events to ensure you receive updates.

   Once the webhooks are configured, the transaction statuses will be synchronized between VTEX and Kushki.

Available payment methods

*In Ecuador, American Express is available based on commercial negotiation.

Plugin operation

• Manage your catalog, prices, and promotions from VTEX.
• Check your transactional reports in the Kushki Console and the VTEX console.

Support

In case of questions or incidents related to payments:

• Email us at soporte@kushkipagos.com
• Go to our 🌐 Kushki Support Center