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

# Connecting your store

> Learn how to connect your shopify store to Paysight.

<Frame>
  <img src="https://mintcdn.com/paysight/Z95DwOvtHWc94TNG/images/paysight_shopify_connect.png?fit=max&auto=format&n=Z95DwOvtHWc94TNG&q=85&s=fd55c6e9ce247d7a0a83d81ea335d438" alt="" width="1200" height="630" data-path="images/paysight_shopify_connect.png" />
</Frame>

<Info>
  This guide covers the quickest way to get your Shopify store connected to paysight, if you are looking for checkout customisation, please visit [Checkout Editor](/guides/shopify-store-editor) documentation
</Info>

## Before you start

Have these details ready before you begin:

<CardGroup cols={2}>
  <Card title="Shopify access" icon="store">
    You need the Shopify store URL and the four-digit Shopify collaborator request code.
  </Card>

  <Card title="Domain access" icon="globe">
    You need access to the DNS provider for the checkout domain or someone who can add DNS records.
  </Card>

  <Card title="Brand details" icon="palette">
    Prepare the customer-facing store name, website, logo, color, and support contact details.
  </Card>

  <Card title="Checkout setup" icon="credit-card">
    Confirm subscription, product, payment profile, shipping, card, wallet, and 3DS requirements.
  </Card>

  <Card title="Shipping product" icon="truck">
    If the store charges shipping, create a dedicated unlisted Shopify product for shipping and sync it back to Paysight before configuring checkout shipping.
  </Card>
</CardGroup>

## How boarding works

Onboarding shopify store to paysight involves a little bit of back and forth because some of the process cannot be automated. We have automated as much as we could but you will have to wait for you account manager to handle certain steps for you.

<Frame>
  <img src="https://mintcdn.com/paysight/Z95DwOvtHWc94TNG/images/image-1.png?fit=max&auto=format&n=Z95DwOvtHWc94TNG&q=85&s=c25972ab6e234f09be33c7cf16a42064" alt="Image" width="1926" height="422" data-path="images/image-1.png" />
</Frame>

**The onboarding wizard will inform you when you are waiting for paysight to handle a step.**

* Paysight will confirm when collaborator request is accepted
* Paysight will confirm when Paysight Shopify App is installed
* Paysight will confirm when DNS & SSL is connected.
* Paysight will confirm when shopify store is full connected.

<Tip>
  Onboarding is resumable. If a step depends on Paysight review, DNS propagation, or Shopify access, return to the Onboarding tab later and select the store to continue.
</Tip>

## Start onboarding

<Steps>
  <Step title="Open Shopify Stores">
    In Paysight, go to **Shopify Stores** and select **Add store**.

    If you already started onboarding, open the **Onboarding** tab and resume the pending store instead.
  </Step>

  <Step title="Submit the store request">
    Enter the store name, Shopify store URL, and Shopify collaborator code.

    Paysight uses this information to request collaborator access and prepare the store record.

    <Frame>
      <img src="https://mintcdn.com/paysight/oFGJ6H5IH9lVmsld/images/image-6.png?fit=max&auto=format&n=oFGJ6H5IH9lVmsld&q=85&s=921468aa09944a7923e839fd35125caf" alt="Image" width="2138" height="652" data-path="images/image-6.png" />
    </Frame>
  </Step>

  <Step title="Create or select the brand">
    Brand is a Paysight item used to link stores, mids, companies together.  \
    You can either create a new brand by entering a Brand name and customer facing domain (your store link) or use an existing on if you've already setup a brand.\\

    <Frame>
      <img src="https://mintcdn.com/paysight/oFGJ6H5IH9lVmsld/images/image-7.png?fit=max&auto=format&n=oFGJ6H5IH9lVmsld&q=85&s=d1b01713e251c639856ebb9516fb67ee" alt="Image" width="2142" height="826" data-path="images/image-7.png" />
    </Frame>
  </Step>

  <Step title="Configure DNS">
    Decide on a subdomain that you want to use for your checkout, for example **checkout.**\
    Customers will land on **checkout.yourstore.com** when they go to checkout via paysight.\\

    <Frame>
      <img src="https://mintcdn.com/paysight/oFGJ6H5IH9lVmsld/images/image-8.png?fit=max&auto=format&n=oFGJ6H5IH9lVmsld&q=85&s=95c8737d572402fa2d8364ae34165a9e" alt="Image" width="2150" height="1400" data-path="images/image-8.png" />
    </Frame>

    \
    Enter the checkout subdomain and root domain, then add the DNS records shown in Paysight.

    DNS verification may take time. You can continue other setup work while records propagate. Final DNS verification will be completed by paysight.
  </Step>

  <Step title="Set up subscription and product">
    Choose a subscription setup or use a no-subscription configuration, then create the product payment profile for the store.

    This ties checkout submissions to the correct Paysight product and payment routing.

    You will be asked to connect a **Merchant Account (MID)** to the subscription and Product (payment profile), if you do not have a mid, click on '**I don't have a MID yet**' which will generate and assign a sandbox merchant account, this can be changed later.

    <Frame>
      <img src="https://mintcdn.com/paysight/oFGJ6H5IH9lVmsld/images/image-10.png?fit=max&auto=format&n=oFGJ6H5IH9lVmsld&q=85&s=4da5b57f10eb9a57693004211450aa90" alt="Image" width="1948" height="2166" data-path="images/image-10.png" />
    </Frame>
  </Step>

  <Step title="Add brand and checkout basics (Optional)">
    Add the checkout logo, brand color, support email, support phone, support URL, default country, footer links, and checkout labels.

    These settings control what customers see during checkout and after purchase.
  </Step>

  <Step title="Configure payments (Optional)">
    Choose card checkout behavior, supported card brands, express wallet defaults, and 3DS options.

    Leave uncertain payment settings unchanged and confirm requirements with your Paysight account manager.
  </Step>

  <Step title="Link Shopify checkout">
    This step can only be completed when collaborator access is confirmed, Shopify app has been installed, DNS is verified and SSL has been created. 

    You can follow the guide to link the checkout yourself or request assistance on this step.
  </Step>
</Steps>

## Onboarding statuses

<Tabs>
  <Tab title="You can continue">
    Complete any available step shown in the onboarding flow. Optional checkout settings can be skipped and edited later in the Checkout Editor.
  </Tab>

  <Tab title="Waiting on DNS">
    DNS records must be saved in your domain provider and verified before checkout can be linked. Propagation can take time depending on the DNS provider.
  </Tab>

  <Tab title="Waiting on Paysight">
    Paysight may need collaborator access approved, a Shopify app installed, or checkout script setup before the final Shopify link can be confirmed.
  </Tab>
</Tabs>

## What each step changes

<AccordionGroup>
  <Accordion title="Store request">
    Captures the store name, Shopify URL, and collaborator code so Paysight can prepare access and create the onboarding record.
  </Accordion>

  <Accordion title="Brand">
    Creates the brand and domain record used by the checkout. This is the identity customers see on the checkout page.
  </Accordion>

  <Accordion title="DNS">
    Saves the checkout domain and DNS records, then verifies the records needed to serve checkout securely.
  </Accordion>

  <Accordion title="Subscription">
    Configures the subscription model used by checkout, or a no-subscription path when the store does not sell subscriptions.
  </Accordion>

  <Accordion title="Product (Payment Profile)">
    Creates and associates the Paysight product/payment profile used for checkout submissions.
  </Accordion>

  <Accordion title="Brand & support">
    Sets optional customer-facing logo, color, support email, support phone, support URL, and website details.
  </Accordion>

  <Accordion title="Checkout basics">
    Sets checkout copy such as pay button text, contact/delivery/payment labels, default country, and footer links.
  </Accordion>

  <Accordion title="Payments">
    Sets optional card, wallet, supported-card, and 3DS defaults for the store.
  </Accordion>

  <Accordion title="Link Shopify checkout">
    Confirms the Shopify side is ready, verifies checkout routing, and completes onboarding.
  </Accordion>
</AccordionGroup>

Once onboarding is complete, open the active store from **Shopify Stores** and select **Edit Checkout** to manage checkout settings in the [Shopify Checkout Editor](/guides/shopify-store-editor).

<Info>
  If your store uses shipping, you must first create an unlisted product on your shopify store.\
  You can call it anything, eg. Standard Shipping, and set the price to 0.\
  \
  Then simply re-sync your shopify products back to paysight in the Checkout Editor and use this product as shipping identifier for your dynamic paysight shipping options.
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I cannot continue to the next step">
    Required previous steps must be completed before later steps unlock. Some steps also depend on DNS verification or Shopify access being accepted.
  </Accordion>

  <Accordion title="DNS has not verified yet">
    Confirm the DNS records match exactly, then wait for propagation. If the records are correct but still not verified, contact your Paysight account manager.
  </Accordion>

  <Accordion title="Checkout does not redirect from Shopify">
    Confirm the checkout script is installed in the active Shopify theme and that Paysight has confirmed the Shopify link step. In rare cases of script not functioning properly due to theme issues, please open a support ticket or reach out to your account manager.
  </Accordion>

  <Accordion title="I need to change checkout copy or payments later">
    Complete onboarding first, then update those settings from the Checkout Editor for the active store.
  </Accordion>
</AccordionGroup>