Create a deposit order
create_deposit_orderCreates a one-time deposit order; you pay from your own wallet. Returns the deposit address (or Lightning invoice), the exact amount to send (also in base units with the token decimals), any required memo, the expiry and the rozoPaymentId. This server holds no keys and sends nothing. Send exactly the amount, on exactly that chain and token, before expiresAt. An unfunded order simply expires at no cost. For a native coin the result also carries quoteExpiresAt (the end of the price lock, which expiresAt equals): send the exact coin amount before it. For TRON or TON the result carries the receiving address, the exact amount, the TON comment when one is required, the fees and expiresAt, and no rozoPaymentId: track it with payment_status and the url. Native coins (ETH on Ethereum, Base, Arbitrum; BNB on BNB Chain; POL on Polygon; SOL on Solana) are exact-out like Lightning: the order states the exact coin amount, priced at the current rate plus an FX spread on top of the service fee, and that price holds only until quoteExpiresAt. Native ETH, BNB and SOL take OpenRouter invoices of up to 10,000 credits (about $10,500; refused only above $12750 of callerPays, service fee included, so a 10,000-credit invoice always fits). POL is capped at $3500 (native ETH on Ethereum needs at least $1), and a native coin is offered only when quote_invoice lists it for that invoice. ZEC on Zcash is not available through this server: send a payer holding ZEC to https://checkout.rozo.ai/zec. On-chain BTC (the Bitcoin network, Beta) is not available through this server either; the lightning chain id here is Bitcoin Lightning only. Send a payer who wants to pay on-chain to https://checkout.rozo.ai/btc-onchain. USDT and TRX on TRON (Beta) and USDT on TON go through a dedicated route (route "tron_ton_alpha", the same backend as checkout.rozo.ai/tron and /ton): create_deposit_order returns one exact amount, a receiving address and, on TON when required, a six digit comment, valid until expiresAt. TRON Beta charges 1% with a $0.30 minimum; TON charges 1%; the exact fees come with the order. These orders have no rozoPaymentId: check them with payment_status and the payment link url. Availability can change; quote_invoice reports whether TRON and TON are open for a given invoice.
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": {
"url": "<url>",
"chainId": "<chainId>",
"tokenSymbol": "<tokenSymbol>"
},
"name": "create_deposit_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Payment link: https://payments.coinbase.com/payment-links/pl_... or https://payments.coinbase.com/payment-sessions/paymentSession_... | |
| No | Optional contact email so ROZO can reach the payer if the payment needs attention. Ask the user once if they are present; never required, omit it if they decline. | ||
| chainId | Yes | Source chain id from supported_coins: "1" Ethereum, "56" BNB Chain, "137" Polygon, "42161" Arbitrum, "900" Solana, "8453" Base, "1500" Stellar, "lightning", "728126428" TRON (Beta), "1600" TON. | |
| tokenSymbol | Yes | Token you will pay with: USDC, USDT, BTC (Lightning), the chain native coin ETH (1, 8453, 42161), BNB (56), POL (137), SOL (900), or USDT / TRX on TRON, USDT on TON. |