Shopify: complete setup and operating guide

Features, installation, checkout settings, daily payment operations, testing, troubleshooting and limitations

The basics
The Paypercut app connects your Shopify checkout to your payment account. The app is different from your Paypercut merchant dashboard, where you manage the underlying payments.

At a glance: what this integration supports

Paypercut provides a hosted card-payment flow at Shopify checkout. Customers select Pay by card, complete authentication if required on the Paypercut page, then return to Shopify. Shopify-initiated captures, refunds and cancellations are forwarded to Paypercut. Unlike other plugins, there is no separate webhook setup to perform.

Install the payment provider

  1. Open the official Paypercut listing in the Shopify App Store and choose Install.
  2. Select your store and approve requested permissions.
  3. After installation, open Shopify Settings → Payments and find the installed Paypercut payment method. Choose Manage account. Do not rely on the payment-provider search: the docs say it does not yet find Paypercut.

Connect your Paypercut account

  1. In your Paypercut Merchant Dashboard, create a Sandbox API Secret and, after approval, a Live API Secret.
  2. On the Paypercut setup page accessed from Manage account, fill in Sandbox API Secret (sk_test_…) and/or Live API Secret (sk_live_…).
  3. Choose Submit. The keys are created in Paypercut, not Shopify; keep them confidential.

Test mode versus real payments

Shopify’s Paypercut Test mode switch chooses which saved key is used. When Test mode is on, orders are simulated using your sandbox key. With Test mode off, real payments require a live key. Setting the switch without the matching key results in failed transactions.

Capture, cancel and refund Shopify orders

  1. Open Shopify Admin → Orders and select the Paypercut-paid order.
  2. For an authorized order, use the available capture action in Shopify if your workflow requires collecting money later.
  3. For a completed payment, issue a refund through Shopify order management; for an authorization, cancel when appropriate.
  4. Check the resulting payment status in Shopify and in the Paypercut dashboard. Do not separately perform the same refund in both systems.

Before going live

  1. Run a test checkout with Test mode on and check the Shopify order record.
  2. Confirm your live Paypercut merchant account is approved and the live key is saved.
  3. Switch Test mode off, make a small real payment and verify the order and Paypercut transaction.

capture, cancel and refund Paypercut payments

In Shopify Orders, open the order paid with Paypercut. Use the relevant Shopify action to capture an authorized payment, cancel an eligible authorization, or refund a completed charge. Check the outcome in Shopify and Paypercut. Do not repeat the same refund from both systems.

Use Shopify order management

  1. Open Shopify → Orders and select the relevant Paypercut order.
  2. Review whether payment is authorized, paid or already refunded.
  3. Choose Capture for an eligible authorized payment, Refund for collected money, or Cancel when applicable.
  4. Confirm the action and compare the updated order with its payment in the Paypercut Dashboard.

Keep records consistent

Avoid repeating the same refund in the Paypercut dashboard after processing it through Shopify. No manual webhook configuration is required for this integration.

Do not assume

Shopify supports card payments, test mode and payment actions such as capture, cancellation and refund. For other payment methods or recurring billing, contact Paypercut before advertising them to customers.


Official Paypercut documentation

For advanced configuration and technical details, see the official Paypercut documentation.

Open documentation


Need more help?

Find the right support contact for your question.

Contact support