> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quidkey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Onboarding

> Connect your Shopify store to Quidkey and enable Pay by Bank in your checkout

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

<CardGroup cols={2}>
  <Card title="To test Quidkey" icon="flask">
    * 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.
  </Card>

  <Card title="To go live" icon="rocket">
    * 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.
  </Card>
</CardGroup>

## Step 1: Create Your Quidkey Account

<Steps>
  <Step title="Sign up">
    Go to [console.quidkey.com/signup](https://console.quidkey.com/signup) and create your account.

    <Frame>
      <img src="https://mintcdn.com/quidkey/7WKQz3NDFbdU-tiZ/images/shopify/signup-page.png?fit=max&auto=format&n=7WKQz3NDFbdU-tiZ&q=85&s=20d0ba84846f3b382259cb83a06fa524" alt="Quidkey signup page" width="1170" height="1394" data-path="images/shopify/signup-page.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/quidkey/7WKQz3NDFbdU-tiZ/images/shopify/quidkey-dashboard.png?fit=max&auto=format&n=7WKQz3NDFbdU-tiZ&q=85&s=d76c795790f601f54be9728109ca3f3e" alt="Quidkey Dashboard with the Go Live checklist" width="3008" height="1542" data-path="images/shopify/quidkey-dashboard.png" />
    </Frame>
  </Step>
</Steps>

## Step 2: Install the Shopify App

You can also open the app directly: [apps.shopify.com/quidkey-checkout](https://apps.shopify.com/quidkey-checkout).

<Steps>
  <Step title="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.
  </Step>

  <Step title="Install the app">
    Click **Install**.

    <Frame>
      <img src="https://mintcdn.com/quidkey/e75LdWHYnAqazGsD/images/shopify/shopify-app-store.png?fit=max&auto=format&n=e75LdWHYnAqazGsD&q=85&s=337b98439676ab34a30733de9afe7711" alt="Shopify App Store page for Pay by Bank" width="3024" height="1720" data-path="images/shopify/shopify-app-store.png" />
    </Frame>
  </Step>

  <Step title="Approve permissions">
    Shopify will show the permissions screen. Click **Install** again to approve.

    <Frame>
      <img src="https://mintcdn.com/quidkey/e75LdWHYnAqazGsD/images/shopify/shopify-permissions.png?fit=max&auto=format&n=e75LdWHYnAqazGsD&q=85&s=7585696fe25aad59ca69666dc05e4e28" alt="Shopify permissions screen for Pay by Bank" width="3024" height="1708" data-path="images/shopify/shopify-permissions.png" />
    </Frame>
  </Step>

  <Step title="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>
</Steps>

## 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.

<Steps>
  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/quidkey/7WKQz3NDFbdU-tiZ/images/shopify/credentials-tab.png?fit=max&auto=format&n=7WKQz3NDFbdU-tiZ&q=85&s=b0c2889c5068029b5baf35678fdfc1af" alt="Credentials tab in the Quidkey Console" width="2988" height="1140" data-path="images/shopify/credentials-tab.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/quidkey/7WKQz3NDFbdU-tiZ/images/shopify/generate-client-secret.png?fit=max&auto=format&n=7WKQz3NDFbdU-tiZ&q=85&s=60e4167cc6719f880db84dba57ec5cf3" alt="Client Secret popup shown in the Quidkey Console" width="1564" height="936" data-path="images/shopify/generate-client-secret.png" />
    </Frame>

    <Warning>
      Your Client Secret is shown **only once**. Copy it immediately and paste it into Shopify.
    </Warning>
  </Step>

  <Step title="Connect">
    Paste the Client Secret into the **Client secret** field in Shopify, then click **Connect Quidkey**.

    <Frame>
      <img src="https://mintcdn.com/quidkey/e75LdWHYnAqazGsD/images/shopify/connect-quidkey.png?fit=max&auto=format&n=e75LdWHYnAqazGsD&q=85&s=ac5d9e26e0e7c71599b45b7001c8f28d" alt="Shopify Connect Quidkey page where you paste your Client ID and Client Secret" width="3413" height="1770" data-path="images/shopify/connect-quidkey.png" />
    </Frame>
  </Step>
</Steps>

### 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.

<Frame>
  <img src="https://mintcdn.com/quidkey/e75LdWHYnAqazGsD/images/shopify/toggle-test-mode.png?fit=max&auto=format&n=e75LdWHYnAqazGsD&q=85&s=f55d73e90d01d21e0f56932732d4f2fe" alt="Activate Pay by Bank App with Test Mode enabled" width="3414" height="1774" data-path="images/shopify/toggle-test-mode.png" />
</Frame>

## 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.

<Frame>
  <img src="https://mintcdn.com/quidkey/7WKQz3NDFbdU-tiZ/images/shopify/pay-by-bank-spotlight.png?fit=max&auto=format&n=7WKQz3NDFbdU-tiZ&q=85&s=46bfe337afdcd011da72959e8352d7d8" alt="Pay by Bank Spotlight indicator shown on a product page" width="928" height="114" data-path="images/shopify/pay-by-bank-spotlight.png" />
</Frame>

<Steps>
  <Step title="Open the theme editor">
    In your Shopify admin, go to **Online Store** > **Themes** and click **Customize** on your active theme.
  </Step>

  <Step title="Enable the app embed">
    In the theme editor sidebar, open **App embeds**. Find **Pay by Bank Spotlight**, turn the toggle on, and click **Save**.

    <Frame>
      <img src="https://mintcdn.com/quidkey/e75LdWHYnAqazGsD/images/shopify/theme-editor-app-embeds.png?fit=max&auto=format&n=e75LdWHYnAqazGsD&q=85&s=94f1083d4794115597ec8bce1759d97f" alt="Theme editor App embeds page showing Pay by Bank Spotlight toggle" width="3420" height="1778" data-path="images/shopify/theme-editor-app-embeds.png" />
    </Frame>
  </Step>

  <Step title="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>
</Steps>

## Step 5: Test Your Checkout

You can try Pay by Bank immediately, without completing KYC.

<Warning>
  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.
</Warning>

<Steps>
  <Step title="Open your staging URL">
    Go to `https://{your-store-name}.myshopify.com`.
  </Step>

  <Step title="Add a product and checkout">
    Add any product to your cart and proceed to checkout.
  </Step>

  <Step title="Select Pay with your bank">
    You should see **Pay with your bank** as a payment option.

    <Frame>
      <img src="https://mintcdn.com/quidkey/e75LdWHYnAqazGsD/images/shopify/checkout-pay-by-bank.png?fit=max&auto=format&n=e75LdWHYnAqazGsD&q=85&s=8f71e6f598f4c2f0fcd2749e0f84dc5c" alt="Checkout page showing Pay with your bank available in test mode" width="1148" height="716" data-path="images/shopify/checkout-pay-by-bank.png" />
    </Frame>
  </Step>

  <Step title="Complete the test payment">
    Choose any test bank and complete the simulated flow. Check your Quidkey dashboard to confirm the test order appears.
  </Step>
</Steps>

<Check>
  If you see "Pay with your bank" at checkout and can complete a test payment, your integration is working correctly.
</Check>

## 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

<Frame>
  <img src="https://mintcdn.com/quidkey/7WKQz3NDFbdU-tiZ/images/shopify/quidkey-dashboard.png?fit=max&auto=format&n=7WKQz3NDFbdU-tiZ&q=85&s=d76c795790f601f54be9728109ca3f3e" alt="Go Live checklist in the Quidkey Dashboard" width="3008" height="1542" data-path="images/shopify/quidkey-dashboard.png" />
</Frame>

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.

<Steps>
  <Step title="Open your Shopify Pay by Bank app settings">
    In your Shopify admin, open the Pay by Bank app settings.
  </Step>

  <Step title="Turn off Test Mode">
    Toggle Test Mode off. Your store is now live and ready to accept real Pay by Bank payments.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="Pricing not updated">
    * Pricing is applied after KYC/KYB verification is complete
    * In test mode, default pricing is used
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="How long does KYC take?">
    Usually minutes, depending on the documents provided. We'll notify you once verification is complete.
  </Accordion>

  <Accordion title="How do payouts work?">
    Payouts are sent to your designated business bank account after KYC approval. Payout frequency and timing depend on your plan.
  </Accordion>

  <Accordion title="Can I collect a one-off payment outside of checkout?">
    Yes. Use [Payment Links](/guides/payment-links/overview) 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](/guides/payment-links/console) with no code.
  </Accordion>
</AccordionGroup>

## Support

Questions? We're here to help:

* Email: [support@quidkey.com](mailto:support@quidkey.com)
* Slack: We can create a shared channel for ongoing communication
* Video calls: Contact [support@quidkey.com](mailto:support@quidkey.com) to schedule one