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.
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.
If your integration requires specific notifications for chargebacks, ask your technical contact at Kushki to enable these notifications at the following production URL: https://prod.y.uno/kushki-webhook/v1/confirmations
Available payment methods#
| Payment Method | CL | CO | EC | MX | PE |
|---|
| Credit/Debit Cards | ✅ Visa, MasterCard | ✅ Visa, MasterCard, Diners Club, Amex | ✅ Visa, MasterCard, Amex* | ✅ Visa, MasterCard | ✅ Visa, MasterCard, Diners Club, Amex |
| Bank Transfers | - | ✅ PSE | - | ✅ SPEI | - |
| Full Refunds | ✅ | ✅ | ✅ | ✅ | ✅ |
| Partial Refunds | ✅ | ✅ | ✅ | ✅ | ✅ |
| Installment Payments | ✅ | ✅ | ✅ | ✅ | ✅ |
| Gift Cards | ✅ | ✅ | ✅ | ✅ | ✅ |
*In Ecuador, American Express is available based on commercial negotiation.Available payment methods may vary depending on the country and your business configuration. Confirm with your Kushki advisor before activating new options.
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:
