---
title: "Merchant Connect"
method: GET
path: "/v1/merchants/connect"
tags: ["Payments"]
---

# Merchant Connect

`GET /v1/merchants/connect`

Initiate merchant onboarding. Called by e-commerce platform plugins (WooCommerce, Medusa, etc.) to start the connect flow. Creates a session in Redis and redirects the merchant to the BKey approval page where they prove their identity with biometric approval. No authentication required — this endpoint is part of the onboarding handshake.

## Query parameters

- `store_url` string, uri, required
- `platform` 'woocommerce' | 'shopify' | 'medusa' | 'bigcommerce'
- `return_url` string

## Other responses

- `302` — Redirect to the BKey approval page. The client must follow the Location header to complete the merchant onboarding handshake.
- `400` — Invalid store_url, unsupported platform, or SSRF rejection

---

[API](https://skmtc.net/bkeyid/apis/bkey-api.md) · [All operations](https://skmtc.net/bkeyid/apis/bkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bkeyid/bkey-api/revisions/304d4d4d93c7/schema)