---
title: "Mark a quote's payment settled (the payment-link rail's resume,"
method: POST
path: "/v1/agent-door/paid/{quoteId}"
tags: ["platform-push"]
---

# Mark a quote's payment settled (the payment-link rail's resume,

`POST /v1/agent-door/paid/{quoteId}`

## Request

- Base URL: `https://api.bubblio.dev`
- URL: `https://api.bubblio.dev/v1/agent-door/paid/{quoteId}`
- Auth: HTTP bearer

Called from the platform's `checkout.session.completed` webhook (the SDK's
`resumePaidQuote` / `completeBubblioCheckout`). Same signed-push authentication as
the results endpoint. Bubblio refuses a settlement whose `args_hash` or amount
doesn't match the quote's pin — the money must buy exactly the pinned call — and
every refund-worthy refusal means the payment bought nothing (the SDK auto-refunds
it on the platform's own Stripe). After a settle, the visiting agent's next confirm
poll executes the action, payment already made.

## Path parameters

- `quoteId` string, required

## Headers

- `X-Bubblio-Signature-V2` string, required
- `X-Bubblio-Timestamp` string, required

## Request body

- object
  - `quoteId` string, required
  - `args_hash` string: The session's metadata.args_hash — must match the pin.
  - `payment` PaymentSummary, required: The settled charge as receipts carry it — facts only, never a credential.
    - `rail` string, required
    - `amount_cents` integer, required
    - `currency` string, required
    - `ref` string, required: The provider reference (Stripe PaymentIntent / Checkout Session id).

## Response `200`

Settled (with `already: true` on a webhook redelivery — benign).

- object
  - `ok` boolean
  - `already` boolean

## Other responses

- `400`: Malformed, or a coded mismatch (`amount_mismatch`, `args_mismatch`).
- `404`: Uniform miss (unknown quote / failed signature), same doctrine as the results push.
- `409`: Coded refusal: `expired`, `already_settled`, `not_payable`, or `conflict` (transient race — the webhook redelivery decides).
- `413`: Body over 16KB.

---

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