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

# Quickstart

> Get your first Quidkey payment working in minutes

Quidkey offers two ways to collect bank-to-bank payments. Choose the path that fits your use case, then follow the guide to get your first payment working.

<Card title="Sign Up for Credentials" icon="user-plus" href="https://console.quidkey.com" size="lg">
  Create your merchant account to get your client\_id and client\_secret. **Time to complete:** 2-4 hours
</Card>

## Choose Your Integration

<CardGroup cols={3}>
  <Card title="Shopify" icon="shopify" href="/guides/shopify/onboarding">
    Install the Quidkey Shopify app and enable Pay by Bank at checkout. No code required.

    **Best for:** Shopify merchants

    **You'll need:** Shopify admin access
  </Card>

  <Card title="Embedded Flow (with Stripe)" icon="credit-card" href="/guides/embedded-flow/overview">
    Add Quidkey bank payments alongside your existing Stripe Payment Element.

    **Best for:** Merchants with an existing Stripe checkout

    **You'll need:** Backend + frontend code
  </Card>

  <Card title="Payment Links" icon="link" href="/guides/payment-links/overview">
    Generate shareable URLs that open a Quidkey-hosted checkout page.

    **Best for:** Invoicing, ad-hoc payments, no-code

    **You'll need:** One API call (no frontend code)
  </Card>
</CardGroup>

<Tip>
  **Not sure which to pick?** Use **Shopify** if you're on Shopify. Use the **Embedded Flow** if you have a Stripe checkout and want bank payments inline. Use **Payment Links** if you want to send a payment request without building a frontend.
</Tip>

***

## Authenticate (Both Paths)

Regardless of which integration you choose, the first step is the same: get an access token using your credentials.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST 'https://core.quidkey.com/api/v1/oauth2/token' \
    -H 'Content-Type: application/json' \
    -d '{
      "client_id": "your-client-id",
      "client_secret": "your-client-secret"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://core.quidkey.com/api/v1/oauth2/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      client_id: 'your-client-id',
      client_secret: 'your-client-secret'
    })
  });

  const { access_token } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://core.quidkey.com/api/v1/oauth2/token',
      json={
          'client_id': 'your-client-id',
          'client_secret': 'your-client-secret'
      }
  )

  access_token = response.json()['data']['access_token']
  ```
</CodeGroup>

<Check>
  You should receive an `access_token` valid for 15 minutes. Save this for the next steps.
</Check>

<Tip>
  Don't have credentials yet? [Try it in the API playground](/api-reference/endpoint/issue-token) first. No authentication required for testing!
</Tip>

***

## Next: Follow Your Path

Now that you're authenticated, continue with your chosen integration:

<CardGroup cols={2}>
  <Card title="Embedded Flow: Create a Payment Request" icon="plus" href="/guides/embedded-flow/create">
    Create a payment token and embed the checkout iframe on your site
  </Card>

  <Card title="Payment Links: Create a Checkout Link" icon="link" href="/guides/payment-links/create">
    Generate a shareable checkout URL in one API call
  </Card>
</CardGroup>

***

## More Resources

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/introduction">
    Explore all endpoints with interactive playgrounds
  </Card>

  <Card title="Webhook Setup" icon="webhook" href="/guides/embedded-flow/after-payment">
    Configure webhooks to receive payment status updates
  </Card>
</CardGroup>

## Need Credentials?

<Warning>
  Sign up at [console.quidkey.com](https://console.quidkey.com) to get your `client_id` and `client_secret` for development and production environments.
</Warning>

## Support

Questions? We're here to help:

* Email: [rabea@quidkey.com](mailto:rabea@quidkey.com)
* Response time: Typically within one business day