Receive money
Other wallets pay you at your node's addresses, through Open Payments. Share an address, or ask for a set amount with a payment request.
On this page
Your addresses
Choose Receive on the Dashboard. The Open Payments tab lists your node's wallet addresses: one for each asset you have a ledger for. Each shows two forms of the same address, a short payment pointer and a URL, each with a copy button, and the ledger what arrives there is booked on.
| Payment pointer | URL | Pays in |
|---|---|---|
$pay.example.com |
https://pay.example.com/.well-known/pay |
XRP, the default |
$pay.example.com/pay/dsusd |
https://pay.example.com/pay/dsusd |
DSUSD |
The short one, your node's name alone, pays in the asset marked
default: the first of your ledgers, until you choose
another with its Make … pay in button. The Dashboard
shows it as your payment pointer. The default asset is also reachable
at its own /pay/<asset> form, such as
$pay.example.com/pay/xrp. An address names an asset, never a
ledger or a hub, so where the node keeps the money can change and the address
stays the same.
Payments from other nodes reach yours through its peers, and your node has peers only in a settlement hub. Join the testnet's hub if you haven't yet.
Your name without a domain
A node without a domain name of its own, such as the
desktop app, is named at Dassie's front
door: $<node ID>.dassiepay.net, where the node ID is
your node's 39 characters. A name you
register points there too, at
$<name>.dassiepay.net. The front door passes
payments on to your node only over a connection your node keeps to it,
as its relay. Your node keeps that connection by default, from its
first start, with nothing to set. So it is reached at those names
while it runs.
The wallet says so above your addresses, and under your payment pointer on the Dashboard, with whether your node is connected to the front door now. A moment of connecting after a start is normal. It warns "This address may reach no one" when your node has not reached the front door for a while, or keeps another relay, or none. Then don't hand those addresses, or a request's link, out. Your node still sends payments, and a sender can still pay a payment request's STREAM credentials, below, from an owner app or another STREAM sender: they travel through your node's peers rather than the front door.
The front door has a cost. It is a machine the project runs, so it
learns when your node is online, and it reads the Open Payments
requests it passes on. If you'd rather it didn't, set
DASSIE_RELAY
to a relay of your own, or set it empty to keep none. Either way the
dassiepay.net front door can't reach your node anymore, and the
wallet says so. A domain name of your own avoids the front door:
Core and periphery
explains the difference.
Ask for a payment
A payment request asks for a set amount, or any amount, with a note on what it is for. Whoever pays it sees that note.
- On the Open Payments tab, under Request a payment, pick the asset if you have more than one.
- Type the amount, or leave it empty to take any amount. Add what it is for, if you like.
- Choose Create request, and share the link it shows with whoever pays you. Any Open Payments wallet can pay it, Dassie's Send among them, while the link reaches your node: for a node without a domain name, while it is connected to the front door.
Under STREAM credentials, the request also has a destination address and a shared secret, for a sender that speaks STREAM directly rather than Open Payments. Share those only with the one sender. The request shows in your activity, with what it received.
Deposits on the XRP Ledger
Beside Open Payments, Receive has a tab for each asset, with where to send it on the XRP Ledger testnet: your own account, with its address and the faucet. It needs no destination tag. Add and fund a ledger goes through it.
Where the money stays
What other nodes pay you arrives in your settlement hub of its asset. Your node keeps a generous float there, more than it is likely ever to need to settle with its peers, and moves the rest to your own account. What you deposit goes to your own account too, and your node moves into the hub what it needs there. Your hubs explains the float.
Why it works this way: one balance per asset, with the hub's part of it managed by your node.
