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

# GoKwik

> Connect GoKwik checkout to Ocular using Base URL, App ID, and App Secret from your merchant dashboard to sync orders, payments, and COD data.

Ocular connects to GoKwik using three credentials — the API **Base URL** (sandbox or production), an **App ID**, and an **App Secret** from your GoKwik merchant dashboard.

<CardGroup cols={2}>
  <Card title="What you need" icon="key">
    Base URL, App ID, and App Secret from GoKwik.
  </Card>

  <Card title="What it unlocks" icon="cart-shopping">
    Checkout-funnel analysis, COD vs prepaid splits, address-prefill outcomes, and abandon reasons.
  </Card>
</CardGroup>

<Frame caption="GoKwik connector — Data Management → Connectors → Add connector → GoKwik">
  ![GoKwik connector placeholder](https://placehold.co/1400x600/fff5f0/E34400?text=GoKwik+Connector+—+Add+Screenshot)
</Frame>

***

## <Icon icon="sliders" /> Step 1 · Connector setup fields

When adding the connector, Ocular will ask for the following fields. Decide on these before you start.

<CardGroup cols={2}>
  <Card title="Connector Name" icon="tag">
    Unique recognisable name (e.g., `gokwik_main`). **Cannot be changed** after creation — choose carefully.
  </Card>

  <Card title="Connector Identifier" icon="hashtag">
    Auto-generated by Ocular — no action needed.
  </Card>

  <Card title="Start Date" icon="calendar">
    YYYY-MM-DD — the date from which Ocular should begin pulling GoKwik data.
  </Card>

  <Card title="Lookback Days" icon="clock-rotate-left">
    Default 30. Increase if RTOs, returns, or abandon-recovery events commonly land further out.
  </Card>

  <Card title="Schedule Frequency" icon="repeat">
    Numeric value plus unit (default: every 4 hours).
  </Card>

  <Card title="Auto Sync" icon="toggle-on">
    Toggle on to start syncing automatically as soon as the connector is created.
  </Card>
</CardGroup>

***

## <Icon icon="key" /> Step 2 · Find your GoKwik credentials

### Base URL

<Tabs>
  <Tab title="Sandbox">
    For testing: `https://sandbox.gokwik.co`
  </Tab>

  <Tab title="Production">
    Use the production URL provided to you by GoKwik during onboarding. If unsure, ask your GoKwik account manager.
  </Tab>
</Tabs>

<Warning>
  Using the wrong base URL will result in a failed connection. Confirm sandbox vs production before saving.
</Warning>

### App ID & App Secret

<Steps>
  <Step title="Log in to GoKwik" icon="arrow-up-right-from-square">
    Open your GoKwik merchant dashboard.
  </Step>

  <Step title="Open API Credentials" icon="key">
    Navigate to **Settings → API Credentials** (or **Integrations → App Settings**, depending on your dashboard version).
  </Step>

  <Step title="Copy the values" icon="copy">
    Copy the **App ID** and **App Secret** shown on that page.

    <Warning>
      Keep the App Secret secure — it grants API-level access to your GoKwik account. Do not share it in chat, tickets, or screenshots.
    </Warning>
  </Step>

  <Step title="Keep the App Secret secure ">
    It grants API-level access to your GoKwik account and should not be shared.
  </Step>
</Steps>

***

## <Icon icon="plug" /> Step 3 · Plug the credentials into Ocular

<Steps>
  <Step title="Open the connector form" icon="window">
    In Ocular, open **Data Management → Connectors → Add connector → GoKwik**.
  </Step>

  <Step title="Fill the fields" icon="pen-to-square">
    * **Base URL** — sandbox or production URL from Step 2.
    * **App ID** — from Step 2.
    * **App Secret** — from Step 2.
    * Plus the setup fields from Step 1.
  </Step>

  <Step title="Create the connector" icon="circle-check">
    Click **Create Connector**. Ocular authenticates against the GoKwik API; on success you'll see **Connection successful**.

    Click **Create** — credentials are encrypted in Ocular's vault and the first incremental sync starts within minutes.
  </Step>
</Steps>

***

## <Icon icon="life-ring" /> Troubleshooting

<AccordionGroup>
  <Accordion title="Failed connection" icon="triangle-exclamation">
    Most common cause is the wrong **Base URL** (sandbox vs production). Confirm with your GoKwik account manager and retry.
  </Accordion>

  <Accordion title="Authentication errors" icon="lock">
    Re-copy App ID and App Secret — watch for leading/trailing spaces. If the secret was rotated in GoKwik, you'll need to update Ocular's stored credentials too.
  </Accordion>

  <Accordion title="Status changes not reflecting" icon="rotate-left">
    Increase **Lookback Days** beyond 30 if RTOs or abandonment status changes typically arrive late.
  </Accordion>
</AccordionGroup>

<Note>
  For ticket-writing format when filing a connector issue, see [Working with the Ocular team → Connector-not-working tickets](/overview/working-with-the-ocular-team).
</Note>