Pay inside Rill

Secondary path: pay a priced Rill resource or transfer USD to a handle or agent FQDN.

Same flow over HTTP: POST /pay

Tool

rill_pay

Use this for seed demos and transfers inside Rill. Resource pays credit seller balance; handle transfers settle inside Rill. For any external HTTPS pay link, prefer rill_pay_url instead.

Auth

Wallet key required (rill_vw_* via session, env, or vw_key).

Parameters

Parameter	Type	Required	Description
`resource_id`	string	no	Priced resource id or short id (omit amount for resource pays)
`to`	string	no	Destination handle or agent FQDN for a transfer
`destination`	string	no	Alias of to
`amount`	number	no	USD amount; required for transfers, omit for resource pays
`idempotency_key`	string	no	Safe retries; auto-generated when omitted
`vw_key`	string	no	Overrides the session wallet key
`metadata`	object	no	Opaque metadata stored with the pay

Usage notes

Save receipt_id and pass it to rill_verify_receipt or X-Rill-Receipt on unlock.
Seed demo: pay resource_id SEED23, then GET /demo/echo with X-Rill-Receipt.
Resolve destinations first with rill_resolve_handle when transferring to a handle.
Same flow over HTTP: POST /pay.