Buy a product
create_orderPlace a live order paid from your prepaid balance using a product ID and an exact denomination from the current catalog. Include a recipient phone or email when the product requires one.
Instructions
Places a live order, debited from your prepaid balance. denomination MUST exactly match one of the product's denoms[].retailMinor from get_product — call get_product first to get a current price, since prices can change. recipient is required when the product's recipientType is phone_number or email (E.164 digits, no leading + for phone). Moves real money — only call this once you intend to complete the purchase.
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": {
"productId": "<productId>",
"denomination": "<denomination>"
},
"name": "create_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| productId | Yes | ||
| recipient | No | Phone number or email, required when the product needs one | |
| denomination | Yes | Must exactly match a current denoms[].retailMinor from get_product | |
| idempotencyKey | No | Optional — omit to auto-generate; reuse the same value to safely retry a failed call without double-charging |