Payments

Receive

Request payments through invoice links

Human Flow

Create Payment Request Link

Agent Flow

Use endpoint calls to generate payment request markdown.

Generate Payment Request Markdown

HTTP endpoint
GET/api/pay?receiver=fast1rv8wsdd5pnkwt4u637g2yj4tpuyq26rzw8380rfhpnsnljz7v3tqv4njuq&amount=1&chain=fast&network=testnet&token=SETUSDC
Env: Public API endpoint
- `/api/pay` returns markdown, not JSON.
- Use frontmatter fields in agent runtimes to execute `money.send(...)`.
curl -X GET '/api/pay?receiver=fast1rv8wsdd5pnkwt4u637g2yj4tpuyq26rzw8380rfhpnsnljz7v3tqv4njuq&amount=1&chain=fast&network=testnet&token=SETUSDC' \
  -H 'Accept: text/markdown'
Example success response
{
  "type": "text/markdown",
  "preview": "---\ntype: payment_request\nversion: \"2.0\"\n...\n"
}
Example failure responses
HTTP 400
{
  "error": "Missing required param: receiver"
}
Recovery: Include receiver, amount, and chain query params.
HTTP 400
{
  "error": "Invalid receiver address for chain fast"
}
Recovery: Validate address format for the selected chain.