Prerequisites
To test Quidkey
- A Shopify store with admin access
- A Quidkey account (no documents or contracts required)
To go live
- Business registration details
- Director and beneficial owner information
- Proof of identity
- Business bank account information (for payouts)
Step 1: Create Your Quidkey Account
1
Sign up
Go to console.quidkey.com/signup and create your account.
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.
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.
3
Approve permissions
Shopify will show the permissions screen. Click Install again to approve.
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.
2
Connect
Paste the Client Secret into the Client secret field in Shopify, then click Connect Quidkey.
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:- Scroll to Test Mode
- Turn Test mode on
- Click Activate
Step 4: Enable Pay by Bank Spotlight (Recommended)
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.
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.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.
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:- Complete Business Information
- Add Director and Beneficial Owner Information
- Add a Bank Account
- 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
Pay by Bank doesn't appear at checkout
Pay by Bank doesn't appear at checkout
- 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
Test order not appearing in Quidkey Dashboard
Test order not appearing in Quidkey Dashboard
- 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 not updated
Pricing not updated
- Pricing is applied after KYC/KYB verification is complete
- In test mode, default pricing is used
FAQ
Do I need to complete KYC to test Quidkey?
Do I need to complete KYC to test Quidkey?
No. KYC is only required when you want to go live and receive real payouts. You can fully test the integration without any verification.
Can I use Quidkey alongside other payment methods?
Can I use Quidkey alongside other payment methods?
Yes. Quidkey works alongside any other payment gateway on Shopify. Customers choose their preferred method at checkout.
How long does KYC take?
How long does KYC take?
Usually minutes, depending on the documents provided. We’ll notify you once verification is complete.
How do payouts work?
How do payouts work?
Payouts are sent to your designated business bank account after KYC approval. Payout frequency and timing depend on your plan.
Can I collect a one-off payment outside of checkout?
Can I collect a one-off payment outside of checkout?
Yes. Use Payment Links to collect a Pay by Bank payment with just a shareable link, ideal for invoices or ad-hoc charges. You can create one from the Console with no code.
Support
Questions? We’re here to help:- Email: support@quidkey.com
- Slack: We can create a shared channel for ongoing communication
- Video calls: Contact support@quidkey.com to schedule one