---
title: "Pay an open purchase with a shared payment token."
method: POST
path: "/purchases/{id}/pay"
---

# Pay an open purchase with a shared payment token.

`POST /purchases/{id}/pay`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/purchases/{id}/pay`
- Auth: HTTP bearer

Callable by any active identity of the workspace. The mandate is read from the instrument at Stripe. A successful charge answers status payment_received with activated false; the webhook activates the period. Paying an already active purchase changes nothing.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `instrument` object, required
    - `kind` string
    - `id` string

## Response `200`

Payment received; the webhook activates the period

- object

## Other responses

- `402`: The instrument does not carry this amount
- `404`: Not found
- `409`: Not open, or already active
- `503`: The mandate could not be read; nothing was charged

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)