PAYMENTS

Invoice Links

Create invoice links for services or products

Human Flow

Generate links, inspect lifecycle entries, and preview payment markdown.

state: idle

Create Invoice Link

Latest Link Preview

No invoice link created yet in this dashboard session.

Lifecycle Tracking

last refresh:
No note.

No invoice link entries match current filters.

Markdown Preview

Fetch `/api/pay` markdown from the latest link or a table row to preview content here.

Agent Flow

SDK create/list methods plus HTTP markdown fetch for payment request execution.

Create Invoice Link

SDK method
CALLmoney.createPaymentLink
- Creates a shareable link and appends local lifecycle row at ~/.money/payment-links.csv.
# SDK method (no HTTP endpoint)
# Use JavaScript snippet instead.
Example success response
{
  "url": "https://example.local/receive?receiver=fast1rv8wsdd5pnkwt4u637g2yj4tpuyq26rzw8380rfhpnsnljz7v3tqv4njuq&amount=10&chain=fast",
  "payment_id": "pay_...",
  "chain": "fast",
  "amount": "10"
}
Example failure responses
Failure
{
  "error": "Invalid address for chain fast: fast1...",
  "code": "INVALID_ADDRESS"
}
Recovery: Use a receiver address valid for the selected chain.
Failure
{
  "error": "Amount must be a positive number",
  "code": "INVALID_PARAMS"
}
Recovery: Use decimal notation and a value greater than zero.

List Invoice Links

SDK method
CALLmoney.listPaymentLinks
- Use `direction` and `chain` filters to narrow reconciliation views.
# SDK method (no HTTP endpoint)
# Use JavaScript snippet instead.
Example success response
{
  "entries": []
}
Example failure responses
Failure
{
  "error": "limit must be a positive integer.",
  "code": "INVALID_PARAMS"
}
Recovery: Use a positive integer limit value.

Fetch Payment Markdown

HTTP endpoint
GEThttps://example.local/api/pay?receiver=fast1rv8wsdd5pnkwt4u637g2yj4tpuyq26rzw8380rfhpnsnljz7v3tqv4njuq&amount=10&chain=fast&token=SETUSDC&network=testnet&memo=intent%3Aabc
- Response includes YAML frontmatter with `type: payment_request` and `payment_id`.
curl -X GET 'https://example.local/api/pay?receiver=fast1rv8wsdd5pnkwt4u637g2yj4tpuyq26rzw8380rfhpnsnljz7v3tqv4njuq&amount=10&chain=fast&token=SETUSDC&network=testnet&memo=intent%3Aabc' \
  -H 'Accept: text/markdown'
Example success response
{
  "contentType": "text/markdown",
  "snippet": "---\ntype: payment_request\nversion: \"2.0\"\n...\n---\n\n# Payment Request ..."
}
Example failure responses
HTTP 400
{
  "error": "Missing required param: receiver"
}
Recovery: Provide full receiver/amount/chain params in the URL query.
HTTP 400
{
  "error": "Unsupported chain: unknown-chain. Supported: fast, base, ..."
}
Recovery: Use one of the supported chain names.