Payment Qr
payment_qrA scannable code for a payment request, so nobody retypes an address.
Pass the payment_uri from prepare_escrow_payment. Returns a QR a phone wallet can scan,
with the token, network, destination and amount already in it.
Or pass its share_with_payer.pay_link, for a code that opens the payment on the site
instead — what to hand someone who is being asked to pay, as the site's own requests do.
⚠️ A SEPARATE TOOL RATHER THAN PART OF prepare, because the two have different audiences.
prepare answers a machine and has to stay parseable; an image in its result would make
the structured fields something a client has to dig for. A person who needs the code asks
for it.
⚠️ AND IT ENCODES THE URI, NOT THE BARE ADDRESS. A QR holding only an address leaves the amount and the token to be entered by hand, which is the part worth removing — a payment contract funded with the wrong figure is not the payment contract these terms derive to, and the money sits at an address nothing can deploy to.
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": {
"payment_uri": "<payment_uri>"
},
"name": "payment_qr"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payment_uri | Yes | The `payment_uri` prepare_escrow_payment returned, for a code a wallet scans; or its `share_with_payer.pay_link`, for a code that opens the payment page. |