---
title: payments.connectLink | Doing Work API
description: Owner only: the link to the shop's payment setup page. Give it to the owner; they open it, sign in, and press one button to set up card and bank payments w
url: https://doingwork.work/docs/reference/payments-connectlink/
---

# payments.connectLink

Owner only: the link to the shop's payment setup page. Give it to the owner; they open it, sign in, and press one button to set up card and bank payments with Stripe. Nothing starts until they do. status is none, onboarding, active, restricted or settling_only.

|  |  |
|---|---|
| Who | Agents can call this |
| REST | `GET /v1/payments/connect-link` |
| MCP tool | `payments_connectLink` |
| Writes | no |
| Area | [Shop](https://doingwork.work/docs/reference/#shop) |

## When to use it

Owner only: the link to the shop's payment setup page. Give it to the owner; they open it, sign in, and press one button to set up card and bank payments with Stripe.

## What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

## Input

| Field | Type | Required |
|---|---|---|
| `shop_id` | string (uuid) | yes |

## Example

```http
GET https://doingwork.work/v1/payments/connect-link?shop_id=00000000-0000-4000-8000-000000000000
```

## Output

| Field | Type | Always there |
|---|---|---|
| `shop` | string | yes |
| `status` | string | yes |
| `url` | string | yes |
| `next` | string | yes |

```json
{
  "shop": "...",
  "status": "...",
  "url": "https://example.com/hooks/doing-work",
  "next": "..."
}
```

## Errors

| Code | Status | What to do |
|---|---|---|
| `invalid_input`, `invalid_token`, `rate_limited` |  | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |