A valid request URL is required to generate request examples{
"orderId": "<string>",
"payment": "pending"
}{
"error": {
"code": "backend_resolution_failed",
"message": "<string>",
"retryable": true
}
}{
"error": {
"code": "unauthorized",
"reason": "missing_credentials",
"hint": "<string>"
}
}{
"error": {
"code": "not_found",
"message": "<string>"
}
}{
"error": {
"code": "rate_limited",
"message": "<string>"
}
}{
"error": {
"code": "admission_unavailable",
"message": "<string>"
}
}Whether one checkout was paid
Says whether one of your organisation’s checkouts is still waiting for payment, was paid, failed, or ended without a payment. A delayed payment method that fails creates no order row in GET /v1/fulfilments, so this is the read that tells a failed payment from one that is still being confirmed.
ANSWERS ONLY FOR YOUR OWN ORGANISATION AND SIGN-IN. An order of another organisation, or one written under another sign-in instance, answers exactly as one that never existed.
Hosted deployments only. A local checkout does not mount this route, so calling it there is a 404.
A valid request URL is required to generate request examples{
"orderId": "<string>",
"payment": "pending"
}{
"error": {
"code": "backend_resolution_failed",
"message": "<string>",
"retryable": true
}
}{
"error": {
"code": "unauthorized",
"reason": "missing_credentials",
"hint": "<string>"
}
}{
"error": {
"code": "not_found",
"message": "<string>"
}
}{
"error": {
"code": "rate_limited",
"message": "<string>"
}
}{
"error": {
"code": "admission_unavailable",
"message": "<string>"
}
}Authorizations
The control surface credential. Send Authorization: Bearer <token>.
Two kinds of token are accepted and they are told apart by shape, not by a separate header. A token beginning pbk_ or puk_ is an org scoped API key, whose public half and secret half are generated together and of which only a hash of the secret is ever stored; anything else is treated as an OAuth 2.1 access token and verified against the authorization server's keys.
Both resolve to the same context: an org, a principal and a set of scopes. Nothing downstream branches on which channel you used, with one deliberate exception, key management, which requires a signed-in person so that a key can never mint another key.
Scopes are enforced when MCP tools are REGISTERED rather than when they are called, so a tool your credential cannot use is absent from tools/list rather than refused mid gesture.
Response
This checkout's payment status.
Where one checkout's payment got to. Phones and their delivery are listed by GET /v1/fulfilments.
pending: no payment recorded yet, including a delayed payment method that is still clearing. paid: the payment was recorded. failed: the payment did not go through. closed: the checkout ended without a payment (it expired, a newer checkout replaced it, or it could not be opened).
pending, paid, failed, closed