topup_wallet
Create a Stripe Checkout link that adds funds to the principal's wallet. Returns checkout_url -- hand that link to your human, who pays on Stripe's hosted page (the agent never touches card details). The wallet credits automatically once payment completes; confirm with get_spend_status. amount_minor is in the smallest currency unit (500 = $5.00) and currency must match the principal's wallet currency.
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_minor": "<amount_minor>"
},
"name": "topup_wallet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| currency | No | ISO-4217 currency code. USD is the only currency supported today. | USD |
| cancel_url | No | Where Stripe sends the payer if they abandon checkout. | https://mundane.market/?topup=cancelled |
| success_url | No | Where Stripe sends the payer after a successful payment. | https://mundane.market/?topup=success |
| amount_minor | Yes | How much to add, in integer minor units (cents for USD) -- 5000 means $50.00. Never a float. | |
| idempotency_key | No | Optional key of your own choosing so a retry reuses the existing checkout instead of opening a second one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| topup_id | No | ||
| checkout_url | No | ||
| checkout_session_id | No |