Approve and get the pay link

Sign a plan at the terms_fingerprint from plan_quote, under the brand terms a person at the brand accepted for this key, and get the Stripe Checkout link the brand or its finance person pays (card or Link up to $10,000, US bank account at any size). Only inside the key's mandate: a refusal names the limit (no mandate, expired, signing not allowed, terms not accepted, channel, plan maximum, monthly cap) and how much over, so you can take it to a person. A plan that changed since the quote is refused with terms_changed: quote again. A plan over the campaign's budget is refused with over_budget and its over_by_cents, always: nobody can approve an overage, the brand included, so remove a creator or ask a person at the brand to raise the budget, then quote again. Signing a signed plan returns its order and resumes payment; it never signs twice. Needs an idempotency_key. Scope: plans:approve. MCP tool: approve_plan.

post/plans/{id}/approve

Request

  • Base URL: https://app.distribution.tech/api/v1
  • URL: https://app.distribution.tech/api/v1/plans/{id}/approve
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

Idempotency-Keystring required

8 to 128 letters, digits or . _ : -. Retry with the same key and the same request to get the same answer; it never runs twice.

Request body

terms_fingerprintstring required

The terms_fingerprint from /plans/{id}/quote.

confirm_over_budget_centsinteger

Retired and ignored if sent. No plan over its campaign's budget is approved, so nothing confirms an overage: remove a creator or raise the budget.

Response

OK

plan_idstring uuid
status'approved'
approved_atstring date-time
already_signedboolean
orderobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.