Create Stripe Credit Checkout
x402_create_checkoutCreate a hosted Stripe Checkout session ($10, $25, $100, $250, or $500 prepaid USD credit pack via card, Apple Pay, Google Pay, or Link — zero crypto required) to fund a new or existing master spend key. Use this when provisioning a brand-new account or topping up a low balance reported by x402_get_account or x402_quote_plan; do not use this to check balances (use x402_get_account) or mint child keys (use x402_issue_delegate_key). Opens an external Stripe Checkout URL without charging until a human completes payment. Omit spend_key to create a new master account, or pass a master sbk_* key to top up; delegated subagent keys are rejected with HTTP 403.
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": {
"amount_cents": "<amount_cents>"
},
"name": "x402_create_checkout"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spend_key | No | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. | |
| amount_cents | Yes | Prepaid Stripe credit pack size in USD cents: 1000 ($10), 2500 ($25), 10000 ($100), 25000 ($250), or 50000 ($500). | |
| return_surface | No | Web console surface to redirect the operator to after Stripe Checkout finishes: "x402" (default, quantumatlas.xyz/x402/), "developers", or "app". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the Stripe Checkout session was created. | |
| spend_key | No | Newly generated master sbk_* key (returned only when creating a brand-new account). | |
| account_id | No | Master account identifier that will receive the credit pack. | |
| amount_usd | No | Formatted USD amount of the selected credit pack. | |
| checkout_url | No | Hosted Stripe Checkout URL for the human operator to complete payment. |