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

# buy_connect_status

> Check the progress of a hosted merchant login

Checks the status of a hosted merchant login started with [buy\_connect](/companies/mcp/tools/buy_connect). Call it after the user finishes logging in, and call it again in a few seconds if the link is still in progress.

## Parameters

| Parameter    | Type   | Required | Description                                 |
| ------------ | ------ | -------- | ------------------------------------------- |
| `merchant`   | string | Yes      | Merchant slug (e.g. `doordash`).            |
| `pending_id` | string | Yes      | The `pending_id` returned by `buy_connect`. |

## Returns

One of four states with a message spelling out the next step: `linking` (still in progress, wait a few seconds and call again), `linked` (success, the merchant is ready to shop), `expired` (the session ended before the user finished, start a new `buy_connect`), or `error` (the login failed, try `buy_connect` again). The merchant slug is included when linked.

## Example

```json theme={null}
{ "name": "buy_connect_status", "arguments": { "merchant": "doordash", "pending_id": "pend_8f2c1a" } }
```