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
    • 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 one-time 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 does authorization and capture work in OneClick payments?
      • Receive OneClick payments with authorization and capture
  • Card-present payments
    • Accept card present payments
    • Test data
    • Webhooks for card present
    • 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
    • Shopping experiences and transaction details for bank transfer payments
    • Receive Wire Transfers
    • Check the Status of a Transaction
  • Cash Payments
    • Accept a Cash Payment
    • Authorized locations
    • Error Codes for declined cash transaction
  • Alternative payment methods (APM)
    • How do APM payments work?
    • Accept Yape payments
  • Money Disbursement
    • Wire Transfer
      • How does the disbursement through bank transfer work?
      • Payment disbursement to bank accounts
      • Error codes for transfer disbursements
    • Card
      • How does sending funds to cards work?
      • Send money to a card
      • Error Codes
  • Plugins
    • Shopify
      • Shopify
      • Plugin Operation
    • VTEX
      • VTEX Integration Guide
  • Payment Links
    • Smartlinks
  • 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
    • 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
      • Webhook for card disbursement
    • 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

Plugin Operation

Now that you have the plugin installed and configured, it's time to see how to operate with it and review order statuses, process with various payment methods, request returns, or cancel authorizations.

Order statuses in Shopify#

In Shopify, we can have different statuses for an order. Below are the possible statuses of the order with the plugin:
Paid: the payment has been made correctly.
Expired: the time expired, and it is no longer possible to make the payment (it applies to cash and transfer payments).
Authorized: the payment has been made by means of authorization. In this case, the amount is authorized to be captured later.
Authorized Expiring: the time expired, and it is no longer possible to capture the payment.
Partially refunded: a refund has been made, but it was only performed for an amount less than the total order paid, and the store's stock with the returned products has been updated.
Refunded: a full refund has been made, and the store's stock of all returned products has been updated.
Pending payment: it is waiting for the payment to be made for a card (Only if it enters the retry policy), cash, or transfer. It automatically goes to Paid status when the payment is executed.
Void: an authorization has been made, and the purchase order has been canceled.

Process one-time payments#

To process one-time payments with credit and debit cards, transfers and cash, it is necessary to configure the payment capture method within the Shopify console, the payment capture method as follows: Settings > Payments > Payment Capture, click the Manage button, where a window will be displayed in which we must select Manually capture payment for orders. Finally, click on the Save button, and it will automatically display the following message: Configuration saved.
Process one time payments
📝 Please keep in mind that:
1.
For card, cash, and transfer payments, the merchant must have configured at least one processor for each of these payment methods. This process will work according to the settings established by the merchant or processor.
2.
For cash payments, you cannot set the expiration date. It is set by default to 7 days.
For payments in installments, you must have a processor that supports this option configured in the Kushki console; otherwise, you cannot have deferred payments.

Request a return from Shopify#

Important❗
Refunds can only be requested from Shopify, not through the Kushki Console.
Follow these instructions to request a refund of transactions in Paid status made with credit and debit card. Shopify allows you to make partial or full refunds.
Follow these instructions to request a return:
1.
Sign in to Shopify with your merchant credentials.
2.
Click on the Orders option in the left side menu.
3.
Click on the order to make the refund and enter its details.
4.
Click on Refund at the top right of the screen.
5.
Specify the number of items to be refunded. For full refunds, select all items. For partial refunds, select the indicated items.
If you wish, you can place the Reason for refund below the order. Otherwise, it can be omitted.
6.
Once you enter the values, click on the Refund button located on the lower right side of the window. The page will refresh, and you will see the message Refund in process.
Regardless of the time, all returns will be processed as refunds.
Refunded

Process payments with authorization and capture#

To process one-time payments with credit and debit cards, it is necessary to configure within the Shopify Console, the payment capture method as follows: Settings > Payment > Payment capture and click the Manage button, where a window will be displayed in which we must select Manually capture payment for orders. Finally, click on the Save button, and it will automatically display the following message Settings saved.
Payments with authorization and capture
If you set funds aside with Kushki from your Shopify store, Kushki will allow you to capture funds from your store admin.
Important
If you activate processing with authorization and capture, you will not be able to activate processing with payments in one step, transfer, or cash.
Important
To process payments with authorization and capture, you must consider that it is subject to the policies of each processor, as well as the capture time.
Authorized card transactions will default to Authorized status. To effectively capture funds, follow these steps:
1.
Sign in to Shopify with your merchant credentials.
2.
Click on the Orders option found in the left side menu.
3.
Click on the command to capture. A new window will appear with the details of the order.
4.
Click the Capture payment button.
5.
Enter the Amount to capture and click the Accept button to generate the capture. The following message will appear Capturing a total of PEN 11.80 has started (it depends on the amount and the currency of the country).
Important
You must capture an amount equal to or less than the authorized amount.
6.
The status of the transaction automatically changes from Authorized to Paid.
Capture

Void an authorization#

Shopify allows you to void an authorized transaction. Follow these instructions to request it:
1.
Sign in to Shopify with your merchant credentials.
2.
Click on the Orders option in the left side menu.
3.
Click on the authorized order you wish to cancel, to enter its details.
4.
Click on More actions at the top right of the screen, where a menu will drop down.
5.
Select the Cancel order option. A new screen with options will appear.
6.
Select the reason for void and click the Cancel Order button. The page will refresh, and you will see the Cancel Order message, the order status will be Voided.
Voided
Modificado en 2026-09-25 15:35:57
Anterior
Shopify
Siguiente
VTEX
Built with