Start checkout for a paid upgrade
start_checkoutOptional: a Stripe link for your human to pay for a 24-hour fast-track or a Featured placement. Call only after the user asked for the upgrade and agreed to its terms (termsUrl from the upgrades list); pass its termsVersion as acceptTerms. Returns a checkoutUrl the user opens to pay. Nothing is charged by this tool.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"offer": "<offer>",
"email": "<email>",
"acceptTerms": "<acceptTerms>"
},
"name": "start_checkout"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bot | No | featured-*: share link or directory slug of the listed Bot. | |
| Yes | The user's email for the Stripe receipt and this order. | ||
| offer | Yes | fasttrack-listing for an unlisted Bot; featured-7d or featured-30d for a listed one. | |
| category | No | fasttrack-listing: the directory category. | |
| shareUrl | No | fasttrack-listing: the Bot's x.ai share link. | |
| acceptTerms | Yes | The upgrade's termsVersion, sent only after the user agrees to the terms. |