create_payment_request
Generate a VietQR payment request with a specified amount, description, and optional validity window. Returns a QR image URL and checkout page URL to send to the payer.
Instructions
Create a VietQR payment request.
Args: amount: Amount in VND, minimum 1 000. description: Short description for the payer (e.g. "Order #123 — 2 kg coffee"). ttl_minutes: QR validity window in minutes (5–1 440, default 60). metadata_note: Internal note from the agent (order id, conversation id, etc.) — echoed back in webhook events.
Returns:
id, pay_code, QR image URL, and checkout page URL. Send qr_image_url
or checkout_url to the payer, then call await_settlement(id) to
wait for the money to arrive.
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": "<amount>",
"description": "<description>"
},
"name": "create_payment_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | ||
| description | Yes | ||
| ttl_minutes | No | ||
| metadata_note | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |