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 console.quidkey.com/signup and create your account.
Quidkey signup page
2

Welcome to your Quidkey Dashboard

Your dashboard lists the steps required to finish setting up your account. You can complete them in any order, but we recommend installing the Shopify app first.
Quidkey Dashboard with the Go Live checklist

​
Step 2: Install the Shopify App

You can also open the app directly: apps.shopify.com/quidkey-checkout.
1

Open the App Store listing

Click the Shopify icon on your Quidkey Dashboard. 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 Console and paste them into Shopify.
1

Open the Credentials tab and generate your Secret Key

In your Quidkey Console, open the Credentials tab and click Generate to create your Secret Key.
Credentials tab in the Quidkey Console
Client Secret popup shown in the Quidkey Console
Your Client Secret is shown only once. Copy it immediately and paste it into Shopify.
2

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 Quidkey

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.
Pay by Bank Spotlight indicator shown on a product page
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.

​
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: Add Your Business Information

On your Dashboard you’ll find a Go Live checklist with the required steps before you can start receiving real payments:
  1. Complete Business Information
  2. Add Director and Beneficial Owner Information
  3. Add a Bank Account
Go Live checklist in the Quidkey Dashboard
KYC/KYB verification typically completes in minutes once all details are submitted. Once approved:
  • Live payments will be enabled in your Quidkey account
  • Payouts will be activated
  • Your pricing will be applied

​
Step 7: Start Accepting Payments

Once your business has been approved you can switch off Test Mode and start accepting customer payments.
1

Open your Shopify Pay by Bank app settings

In your Shopify admin, open the Pay by Bank app settings.
2

Turn off Test Mode

Toggle Test Mode off. 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 Console
  • 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: