mcp-gateway

ucp_complete_checkout

Idempotent

Complete a UCP checkout session. Transitions to 'completed' status. Idempotent — safe to retry with the same idempotency_key. PAYMENT MANDATE: this tool also requires one. Send it as the payment_mandate argument if your client cannot set headers, or as an X-Payment-Mandate header. It must carry mandate_id, max_amount_cents, currency, exp, sub, aud. Two of these are rejected outright if guessed: exp is an INTEGER of Unix seconds (not an ISO 8601 date), and aud is this store's slug (the one in the URL you are calling, not a domain). Its currency must match the cart's currency. Demo Store enforces max_amount_cents against the cart total; a real merchant may only observe that boundary, so enforce the buyer's limit in the agent too. The mandate is a spending cap you declare to limit yourself — it authorises nothing and does not prove the buyer's consent — and its sub must be the identity you authenticate as. max_amount_cents is the spending limit the person you are buying for gave you: ask them if they gave none. Schema: https://trusteed.xyz/.well-known/payment-mandate.schema.json. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

Input Schema

TableJSON Schema

Name	Required	Description
`buyer`	No	Buyer name and email, needed to request the approval link.
`agent_key`	No	Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
`checkout_id`	Yes	UCP checkout session ID (valid UUID)
`x402_payload`	No	x402: signed payment for the server offer (omit to get it).
`payment_option`	No	Payment method THE PERSON chose, when preview_checkout returned payment_options. Ask the person; never choose for them. Card numbers and wallet keys are never sent here: the person approves (and, with own_wallet, signs) on the approval page.
`idempotency_key`	Yes	Unique key to prevent duplicate completions. Generate once per attempt.
`payment_handler`	No	Payment handler the store profile publishes. Omit for default.
`payment_mandate`	No	Payment mandate with `mandate_id`, `max_amount_cents` (integer, minor units), `currency` (3 letters, must match the cart's), `exp` (expiry as an INTEGER of Unix seconds — not an ISO 8601 date string), `sub` (the identity you authenticate as — it is compared against it) and `aud` (the store slug this mandate is for, e.g. the slug in the URL you are calling — not a domain). It is a spending cap you declare to limit yourself: it authorises nothing and does not prove the buyer's consent. Use this when your client cannot set an `X-Payment-Mandate` header.
`shared_payment_token`	No	Stripe Shared Payment Token (spt_…) granted by the buyer's agent wallet for payment_method=ACP. Issued by Stripe, scoped to this merchant, amount and currency, and consumed when used: it can be charged once. Only honoured when this deployment enables native ACP settlement.

Output Schema

TableJSON Schema

Name	Required	Description
`id`	Yes
`label`	No
`intent`	No
`status`	Yes
`totals`	Yes
`currency`	Yes
`next_step`	No
`created_at`	Yes
`expires_at`	No	ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.
`extensions`	No
`line_items`	Yes
`updated_at`	Yes
`fulfillment`	No
`next_action`	No
`approval_url`	No
`idempotency_key`	No
`payment_options`	No
`next_step_message`	No
`expires_in_seconds`	No	Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 10, 2026

addedOutput schema / properties / expires_at

Added value: +{
+  "description": "ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.",
+  "type": "string"
+}

addedOutput schema / properties / expires_in_seconds

Added value: +{
+  "description": "Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.",
+  "minimum": 0,
+  "type": "integer"
+}

Changed1 schema field changedOct 10, 2026

changedOutput schema / properties / payment_options / items / properties / reason_unavailable / enum

Previous value: -[
-  "coming_soon",
-  "not_enabled"
-]New value: +[
+  "coming_soon",
+  "not_enabled",
+  "currency_not_supported"
+]

Changed2 schema fields changedOct 5, 2026

changedInput schema / properties / payment_option / enum

Previous value: -[
-  "demo_card",
-  "demo_wallet",
-  "own_wallet"
-]New value: +[
+  "demo_card",
+  "demo_wallet",
+  "own_wallet",
+  "merchant_card"
+]

changedOutput schema / properties / payment_options / items / properties / id / enum

Previous value: -[
-  "demo_card",
-  "demo_wallet",
-  "own_wallet",
-  "kyapay"
-]New value: +[
+  "demo_card",
+  "demo_wallet",
+  "own_wallet",
+  "merchant_card",
+  "kyapay"
+]

AddedOct 2, 2026
RemovedSep 1, 2026

Changed4 schema fields changedAug 24, 2026

addedInput schema / $schema

Added value: +"http://json-schema.org/draft-07/schema#"

addedInput schema / additionalProperties
```
Added value: +false
```

addedInput schema / properties

Added value: +{
+  "checkout_id": {
+    "description": "UCP checkout session ID (valid UUID)",
+    "type": "string"
+  },
+  "idempotency_key": {
+    "description": "Unique key to prevent duplicate completions. Generate once per attempt.",
+    "type": "string"
+  }
+}

addedInput schema / required

Added value: +[
+  "checkout_id",
+  "idempotency_key"
+]

Changed5 schema fields changedJul 10, 2026

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

removedInput schema / additionalProperties
```
Removed value: -false
```

removedInput schema / properties

Removed value: -{
-  "checkout_id": {
-    "description": "UCP checkout session ID (valid UUID)",
-    "type": "string"
-  },
-  "idempotency_key": {
-    "description": "Unique key to prevent duplicate completions. Generate once per attempt.",
-    "type": "string"
-  }
-}

removedInput schema / required

Removed value: -[
-  "checkout_id",
-  "idempotency_key"
-]

changedOutput schema / (root)

Previous value: -{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "additionalProperties": false,
-  "properties": {
-    "created_at": {
-      "type": "string"
-    },
-    "currency": {
-      "type": "string"
-    },
-    "extensions": {
-      "additionalProperties": false,
-      "properties": {
-        "warnings": {
-          "items": {
-            "additionalProperties": false,
-            "properties": {
-              "code": {
-                "type": "string"
-              },
-              "disclosure_url": {
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "severity": {
-                "enum": [
-                  "info",
-                  "caution",
-                  "critical"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "code",
-              "message",
-              "severity"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        }
-      },
-      "type": "object"
-    },
-    "id": {
-      "type": "string"
-    },
-    "idempotency_key": {
-      "type": "string"
-    },
-    "intent": {
-      "additionalProperties": false,
-      "properties": {
-        "action": {
-          "type": "string"
-        },
-        "context": {
-          "type": "string"
-        },
-        "locale": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "action"
-      ],
-      "type": "object"
-    },
-    "label": {
-      "type": "string"
-    },
-    "line_items": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "id": {
-            "type": "string"
-          },
-          "price": {
-            "additionalProperties": false,
-            "properties": {
-              "amount": {
-                "type": "number"
-              },
-              "currency": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "amount",
-              "currency"
-            ],
-            "type": "object"
-          },
-          "product_id": {
-            "type": "string"
-          },
-          "quantity": {
-            "type": "number"
-          },
-          "title": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "product_id",
-          "title",
-          "quantity",
-          "price"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "status": {
-      "enum": [
-        "incomplete",
-        "requires_escalation",
-        "ready_for_complete",
-        "complete_in_progress",
-        "completed",
-        "canceled"
-      ],
-      "type": "string"
-    },
-    "totals": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "type": "number"
-          },
-          "currency": {
-            "type": "string"
-          },
-          "label": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "label",
-          "amount",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "updated_at": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "id",
-    "status",
-    "currency",
-    "line_items",
-    "totals",
-    "created_at",
-    "updated_at"
-  ],
-  "type": "object"
-}New value: +null

First observedApr 28, 2026

TDQS

Score is being calculated.

All mcp-gateway tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?