Skip to content

by Startups.Studio

Order.confirm

POST /{namespace}/orders/{order}/confirm

Confirm records the Customer’s sign-off on delivered work, which closes the Order and earns the Startup its fee.

Noun: Order
Mode: do
Event: Order.confirmed

You, to your agent

Confirm the latest order.

curl -X POST https://api.sb/petpantry.shop/orders/order_1/confirm \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

import { $ } from 'startup-builder'

const order = await $.Order.confirm({ order: 'order_1' })

npx startup-builder do Order.confirm --json '{"order":"order_1"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Order.confirm({ order: 'order_1' })"
  }
}

Inputs

Input	Type	Required	Description
`order`	Order	required	The delivered Order.
`lines`	`json`		The lines confirmed; every delivered line when absent. Each confirmed line bills on its own.

Outputs

Output	Type	Required	Description
`order`	Order	required	The closed Order.

Effects

Emits Order.confirmed.
Performed by the Delivery Manager.
One-way (money): it waits out its delay window, and runs in the send and do modes.
Runs on its own when the acceptance window passes with no dispute.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Order.confirm
The record is not in a state that allows this Verb, so the call is refused.	`refused`	Read the record, run the Verb that moves it to an allowed state, then retry.	Order.confirm

When it waits

Gate	Default
Decision class	Medium: one-way, bounded (money)
Delay window	1 business hour, in which a watcher can pause, redirect or cancel it; then it runs.
Limit	The spend Limit of the Permission or Mandate it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.

Order.cancel

Previous Page

Order.create

Next Page