1. Shopify
Kushki Docs
English
  • Español
  • English
  • Home
  • Quick Start
    • Frequently Asked Questions
    • Moving to Production
    • Policy for Important API Changes
    • Test Data
    • Error Codes
    • Latest Features
  • Payment Glossary
    • Payments Glossary
  • One-time card payments (Online)
    • Supported card brands
    • Functionalities by business model
    • How do third party commissions work?
    • Integration guide Third Party Commissions
    • Network Tokens
    • One-step Payments
      • How do Card Payments Work?
      • Accept a Card Payment
      • Direct charge (without token)
      • Accept One-Time Payments with OTP
      • OTP Authentication Error Codes
      • Error codes for single card payments
    • Two-steps Payments
      • How do single payments with authorization and capture work?
      • Receive payments with authorization and capture
    • Refunds
      • Returns, cancellations, and refunds
    • 3DS Authentication
      • Introduction to 3DS
      • 3DS API integration
      • 3DS integration with kushki.js library
      • 3DS API integration plus kushki.js library
      • 3DS Error Codes
    • Apple Pay Payments
      • Apple Pay Configuration
      • Apple Pay Sandbox testing
  • Recurring Card Payments (Online)
    • Functionalities by business model
    • External subscriptions to Kushki
    • Authenticate your subscriptions with 3DS
    • Accept one-click payments with 3DS
    • Error codes in recurring charges
    • Apple Pay for Subscriptions
    • Scheduled payments
      • How do Credit or Debit Card Payment Recurring Charges Work?
      • Create a recurring charge
      • Manage your Scheduled Charges
    • OneClick Payments
      • Accepting One-Click Payments
      • How do OneClick payments with authorization and capture work?
      • Receive one-click payments with authorization and capture
  • Card-present payments
    • Card present payments
    • Accept card present payments
    • Test data
    • Webhooks for card present
    • Cloud Terminal API
      • Cloud terminal API overview
      • Take payments
      • Cancel a payment request
      • Check the status of a payment request
      • How to print a customized ticket?
    • App-to-app
      • App-to-app overview
      • Take payments
    • Terminal SDK
      • Terminal SDK Introduction
      • Take payments
    • Raw card-present API
      • Raw card-present API overview
      • Cryptographic key exchange
      • Sample script to encrypt information
      • Take Payments
      • Frequently Asked Questions
      • Error codes for card-present transactions
    • Transactions
      • Transactions
      • Cancel payments
    • Kushki One
      • First Steps
      • Autenticación y Cifrado de Requests
      • Accept payments with Kushki One
      • Amount Format
      • Async services and webhooks
      • Printing on SmartPOS terminal
      • Unified Error Catalog — Kushki ONE Connect
    • Kushki One Payment App
      • Overview
      • Process a payment
      • Split payment on the terminal
      • Refunds and PreAuth & Capture
      • Review Your Transactions
      • Terminal Setup
  • Wire Transfers
    • How do Payments by Wire Transfers Work?
    • Banks and transaction details for bank transfer payments
    • Receive Wire Transfers
    • Check the Status of a Transaction
  • Money Disbursement
    • Wire Transfer
      • How Does a Payment Distribution by Wire Transfer Work?
      • Payment Distribution to Bank Accounts
      • Error codes for transfer dispersions
  • Payment Links
    • Smartlinks
  • Plugins
    • Shopify
      • Shopify
      • Plugin Operation
    • VTEX
      • VTEX Integration Guide
  • Payment forms and buttons
    • Kajita
      • How Does it Work?
      • Payment Kajitas
    • Payment Button
      • Overview
      • Generate a payment button
  • Branch Offices Management
    • How to Onboard Submerchants via API
  • Notifications
    • Webhooks
    • Good Practices
    • Check your Webhooks
    • One-time Payments Webhooks
      • Webhook for One-Time Payments made with a card
      • Webhook for One-Time Payments by Wire Transfer
      • Webhook for One-Time Payments in Cash
    • Recurring Payments Webhooks
      • Webhook for Recurring Payments Made with Card
    • Payment Distribution Webhooks
      • Webhook for payment disbursement through wire transfer
    • Payment button Webhooks
      • Webhooks with Payment Button
    • Smartlinks Webhooks
      • Webhooks with Smartlinks
    • Refunds Webhooks
      • Webhook for Voids and Refunds
      • Chargeback Webhooks
HomeMexico 🇲🇽
Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
HomeMexico 🇲🇽
Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
Status
Soporte / Support
English
  • Español
  • English
  1. Shopify

Shopify

Accept payments for your e-commerce in Shopify. Kushki offers a plugin that you can install on your website, simplifying the purchase process for your customers.
Shopify is an e-commerce platform that allows you to build your online store from scratch. You will be able to promote, sell, and send your products, without the need to write a single line of code or have experience developing webs. It is ideal for small and large merchants, since it has tools that will help you scale your merchant. Shopify is currently used by thousands of stores around the world, and it is available in 50 different languages.
For these reasons, Kushki sought to integrate their payment methods by creating a plugin that allows secure and easy payments, and it is available in several countries. The installation and administration details will be found below.
Supported ✅Not supported ❌
Credit and debit card paymentsRecurring charges (Scheduled or One-Click Payments)
Authorization and capture
Cash payments
Transfers
Deferred payments with credit card
Non-interest-bearing months with credit card
Interest-bearing months with credit card
OTP and 3DS authentication
Sift Science anti-fraud engine
Full Refunds
Same-day, full, or partial cancellations in local currency
To keep in mind
Due to our risk policies, the available payment methods and the integration type may vary once you complete the affiliation. We will tell you how to proceed if this process applies to your merchant.

Minimum requirements#

To make the integration and configuration process of the Kushki plugin in your Shopify store, your merchant must meet the following requirements:
Once your merchant is certified by the Kushki team, your merchant must have a Kushki production account, with which the Public API Key and Private API Key will be generated. The access to this account will be provided by our Onboarding team.
You must have a master user in the Kushki console, with which you will be able to manage the features and configurations according to the commercial agreement established between your merchant and Kushki. To request it, contact your assigned sales executive.
Remember to activate and configure the Payment button (webcheckout) service with Kushki, to ensure that the Shopify plugin works.
You must have previously created an account with Shopify. In case you don't have one, access to the Shopify Help Center to create it and generate your domain.

Installation and configuration#

Once you have your store configured in Shopify and have a production account on Kushki, do the following:
1.
Login to your merchant console with your username and password.
2.
In the side menu, select Settings.
3.
In Integrations, choose the option Plugins.
4.
Select Shopify. The screen where you will be able to Configure the content and style of your form will be displayed.
5.
Enter the Domain assigned by Shopify and click on the Save button.
Keep in mind
Your domain can be updated if you want to.
The button Configure the style of your checkout will be enabled, click on it, and modify the appearance of your payment button. Follow the instructions given in Generate a payment button to customize the payment experience in your Shopify store.
6.
Once you save your domain, the information of the Public API Key and the Private API Key associated with your merchant will appear. You can click on the Copy button to add this information to the clipboard.
📝 Note
Credentials can only be modified through a request to our Tech Support team.
7.
In the add a Kushki App in Shopify option, click on the word Here and the system will redirect you to the Shopify Installation Page.
8.
Click on the Add App button.
9.
Enter your Email on the Shopify login screen.
10.
Click “Continuar con el correo electrónico”.
11.
Enter your Password and click “Iniciar sesión”.
12.
Enter the Authentication Code you received on your mobile device.
13.
Click on “Iniciar sesión”.
14.
Choose Your Store.
15.
Choose your Account.
16.
The settings for installing the Kushki plugin will open by default. Click on Install App.
17.
A window will appear in wich you must enter the credentials. Paste the credentials for the Public Key and Personal Key (Private Key) that you copied in the step 6 of this section.
18.
Click “Enviar datos”.
⚠️ Warning
If the E16 code appears on the screen, uninstall the app, go back to step 1 and start the process again.
19.
Click on “Ir a Configuración”.
20.
The system will redirect you to the Settings. In the Payments section, click Add payment methods.
21.
In Search by provider, search the__Kushki__ connector and click Activate.
22.
Check/uncheck the Card Franchises you want to accept in your merchant.
Important
The card franchises must be the same as those configured in the Kushki console of your merchant.
23.
Check if the store is active in test mode. Node that the Enable test mode option must be unchecked; otherwise, please disable it and click Save.
24.
Click the Activate Kushki button, and you will see the Kushki Activated message.

Configuration of the customer contact method and the currency to be transacted#

1.
In the side menu, select Checkout.
2.
In Customer contact method, verify that the Email box is selected. Otherwise, select this option.
3.
Click Save. The following message will appear: Settings saved.
Important
You must activate the Email as the customer's contact method, since it is a necessary to process payments properly.
4.
To set up the currency, in the side menu select __ Store details__.
5.
In Store Currency, choose the currency you're transacting with and select Save.
Warning
Please note that once the currency is set up and you have received your first transaction, you will not be able to change it. To change the currency, or to accept multi-currency transactions, you'll need to click here to contact Shopify. Additionally, you must notify Kushki here to make the corresponding configurations.
Kushki will be enabled for you to receive payments from your customers in your Shopify store.
This is what the payment experience with the Kushki plugin will look like in your Shopify store:

Uninstallation#

1.
Sign in to your Shopify Console.
2.
Go to Settings > Payments, in the Supported payment methods section find Kushki and select Manage, and a new window will immediately open.
3.
Click the Deactivate Kushki button at the bottom of the window.
4.
A confirmation window will appear, click the Deactivate Kushki button to confirm. Once this is done, the following message will be displayed: Kushki deactivated.
5.
Click Uninstall Kushki to remove the Kushki plugin.
6.
A confirmation message will appear, click the Uninstall Kushki button to confirm. Once this is done, the system will display the following message: Kushki uninstalled.
The following GIF will guide you through the plugin uninstall process:
Uninstallation
Modificado en 2026-10-14 19:45:33
Anterior
Shopify
Siguiente
Plugin Operation
Built with