Skip to main content
This guide walks you through connecting your Shopify store to Quidkey and enabling Pay by Bank in your checkout. You can test Quidkey on your Shopify store without completing KYC or KYB — full verification is only required when you’re ready to go live.

​
Prerequisites

To test Quidkey

  • A Shopify store with admin access
  • A Quidkey account (no documents or contracts required)
You can install the app, connect it, and run a full test payment without providing any business information.

To go live

  • Business registration details
  • Director and beneficial owner information
  • Proof of identity
  • Business bank account information (for payouts)
This is the standard KYB/KYC verification required for regulated payment processing.

​
Step 1: Create Your Quidkey Account

1

Sign up

Go to merchants.quidkey.com/signup and create your account with your business details.
2

Land on the Install page

After signup, you’ll land on the Install Quidkey page with Shopify already selected. You’re ready to install the Shopify app directly from this page.
Install Quidkey page with Shopify selected and the Shopify plugin button

​
Step 2: Install the Shopify App

You’ll be redirected to the Shopify App Store after clicking the Shopify card. You can also open the app directly: apps.shopify.com/quidkey-checkout
1

Open the App Store listing

Click the Shopify card on the Install Quidkey page. Shopify will open in a new tab showing the Pay by Bank app.
2

Install the app

Click Install.
Shopify App Store page for Pay By Bank
3

Approve permissions

Shopify will show the permissions screen. Click Install again to approve.
Shopify permissions screen for Pay By Bank
4

Continue to Connect Quidkey

After installation, Shopify will automatically redirect you to the Connect Quidkey page. Keep both Shopify and Quidkey tabs open — you’ll connect them in the next step.

​
Step 3: Connect Shopify to Quidkey

After installation, Shopify redirects you to the Connect Quidkey page. You need to copy your credentials from the Quidkey dashboard and paste them here.
1

Copy your Client ID

Go back to your Quidkey dashboard, find your Client ID, and copy it into the Client ID field in Shopify.
2

Generate your Client Secret

In your Quidkey dashboard, click Generate to create your Client Secret.
Client Secret popup shown in the Quidkey dashboard
Your Client Secret is shown only once. Copy it immediately and paste it into Shopify.
3

Connect

Paste the Client Secret into the Client secret field in Shopify, then click Connect Quidkey.
Shopify Connect Quidkey page where you paste your Client ID and Client Secret

​
Enable Test Mode and Activate

After connecting, Shopify will show your Quidkey payment provider settings. Test Mode is normally enabled by default. If not, enable it manually:
  1. Scroll to Test Mode
  2. Turn Test mode on
  3. Click Activate
This allows you to make test payments safely without affecting real orders.
Activate Pay by Bank App with Test Mode enabled
Pay by Bank Spotlight adds a small guidance indicator on your product pages. It’s not a payment button — the actual Pay by Bank option appears on the checkout page. This indicator helps customers understand early that they can pay with their bank and increases conversion.
1

Open the theme editor

In your Shopify admin, go to Online Store > Themes and click Customize on your active theme.
2

Enable the app embed

In the theme editor sidebar, open App embeds. Find Pay by Bank Spotlight, turn the toggle on, and click Save.
Theme editor App embeds page showing Pay By Bank Spotlight toggle
3

Verify on your store

Open your staging store URL (https://{your-store-name}.myshopify.com), go to any product page, and check that the Pay by Bank indicator appears.
Product page showing the Pay by Bank Spotlight in action

​
Step 5: Test Your Checkout

You can try Pay by Bank immediately, without completing KYC.
To run a test payment, you must use your Shopify staging URL (https://{your-store-name}.myshopify.com), not your custom domain. Test payment methods are only shown on the staging URL.
1

Open your staging URL

Go to https://{your-store-name}.myshopify.com
2

Add a product and checkout

Add any product to your cart and proceed to checkout.
3

Select Pay with your bank

You should see Pay with your bank as a payment option.
Checkout page showing Pay with your bank available in test mode
4

Complete the test payment

Choose any test bank and complete the simulated flow. Check your Quidkey dashboard to confirm the test order appears.
If you see “Pay with your bank” at checkout and can complete a test payment, your integration is working correctly.

​
Step 6: Go Live (When You’re Ready)

You only need to complete verification when you decide to accept real payments. This is done inside your Quidkey Merchant Portal. At the top of your dashboard, you’ll see a Go Live progress bar that guides you through everything needed before accepting real payments.
Go Live progress bar in the Quidkey dashboard
KYC/KYB verification includes:
  • Business registration details
  • Director and beneficial owner information
  • Proof of identity
  • Bank account information for payouts
Once approved:
  • Live payments will be enabled in your Quidkey account
  • Payouts will be activated
  • Your pricing will be applied
Final step in Shopify: Go to your Shopify Pay by Bank app settings and turn off Test Mode. Your store is now live and ready to accept real Pay by Bank payments.

​
Troubleshooting

  • Confirm Shopify Payments is enabled on your store
  • Check that your Client Secret is valid and correctly pasted
  • Try a private/incognito window to remove cached settings
  • Make sure you’re using the staging URL ({store}.myshopify.com) for test mode
  • Verify the Client Secret in Shopify matches your Quidkey dashboard
  • Confirm the app is installed and connected correctly
  • Try disconnecting and reconnecting the app
  • Pricing is applied after KYC/KYB verification is complete
  • In test mode, default pricing is used

​
FAQ

No. KYC is only required when you want to go live and receive real payouts. You can fully test the integration without any verification.
Yes. Quidkey works alongside any other payment gateway on Shopify. Customers choose their preferred method at checkout.
Usually minutes, depending on the documents provided. We’ll notify you once verification is complete.
Payouts are sent to your designated business bank account after KYC approval. Payout frequency and timing depend on your plan.

​
Support

Questions? We’re here to help: