First visit and connecting
How The Satoshi Vision gets a new reader from a free front page to a first 20 sat article and an allowance, asking for each thing only when it is needed.
Anna arrives from a link, reads the front page for free, and meets the wallet only when she taps her first paid article. She pays once, reads the article, and is offered an allowance at the end. Each request comes when its reason is on screen, which is what Connecting a wallet asks of every capability.
The front page
The front page is free, and so are a few articles a week. Every other headline carries its price in small grey text: "About 1p (20 sats)". There is no connect banner, no sign-in button and no count of free articles left.
The price sits on the headline because that is where Anna decides. Pricing sets out why a price shown after the tap is only a receipt. The Satoshi Vision sets its prices in satoshis and converts the local figure each time the page loads, so the two cannot disagree.
Do
Mark free articles as plainly as paid ones on the front page, so the absence of a price is never mistaken for a missing label.
Don't
Put a connect prompt, a sign-in button or a wallet logo on the front page. Nothing there costs money, so nothing there needs a wallet.
The first paid article
Anna taps a paid headline. The headline and the first two paragraphs are free, so she can tell whether she wants the rest. Then comes a panel: "Read the rest for about 1p (20 sats). No subscription, no account." It has one button, Connect wallet to read.
Without a wallet, the same panel would say "To pay here you need a BSV wallet", and the free articles would stay readable, as the errors table recommends.
Do
Show enough of a paid article before the price for the reader to judge it: at least the headline, the standfirst and the opening paragraphs.
Do
Name the price, in satoshis and local currency, on the same panel as the connect button. The reader should know what the first tap costs before the wallet opens.
The connection prompt
Bitcoin SV Wallet's sheet rises over the article: "The Satoshi Vision wants to connect", with the verified domain satoshivision.example.com beneath. Two lines say what connecting means: "It will recognise you with a key made for this site only." and "It can't take any money without asking you." The buttons are Connect and Not now.
Here, connecting is signing in. The wallet gives The Satoshi Vision a key derived for that site, and The Satoshi Vision uses it to remember which articles Anna has bought. Behind the sheet, the article page reads "Waiting for your wallet…" for as long as the sheet is open. It does not time out.
If Anna taps Not now, the article panel returns with one sentence, "You can still read the free articles.", and nothing else changes.
Do
Ask for a key made for this site only at connection, and nothing else: no identity key, no Pass, no spending grant.
Don't
Treat "Not now" as an error. Keep the reader on the article they chose, with the free paragraphs still showing.
The first payment
Straight after connecting, Bitcoin SV Wallet asks for the payment itself: "Pay The Satoshi Vision", "about 1p (20 sats)", the article's title as what it is for, "One-time payment" and "This can't be undone". It has one button, Pay 20 sats. The payment approval list covers what such a sheet must carry. This one adds only the article title.
When Bitcoin SV Wallet reports the payment, the paywall panel disappears and the article continues where the free paragraphs stopped. There is no separate success screen.
Do
Name the article being bought on the wallet's payment sheet, so the reader can see that the thing she tapped is the thing she is paying for.
Do
Open the rest of the article in place the moment the wallet reports the payment accepted, at the paragraph where the free part ended.
The offer of an allowance
At the end of the article, after a line that says "No ads on this article. You paid 20 sats.", a card makes the offer: "Reading more? Let The Satoshi Vision charge up to 500 sats a day, about 25 articles, for 30 days. Articles will open without asking." Buttons Set up and No thanks.
The offer comes after the first payment because Anna now knows what an article costs and what it is worth to her. Asked at connection, the same allowance would be a budget for something she had not seen yet. Pricing makes the step from free to paid one small payment rather than a plan, and this design offers the plan only after that payment. The offer is translated into articles, as Pricing suggests.
Don't
Show the allowance offer before the reader has finished her first paid article, or on any free article.
Do
Treat "No thanks" as final for the visit. The reader goes on paying per article with a wallet prompt each time, and the card does not return until her next visit.
Asking for an allowance
- OK: after the reader has paid for one article, with the amount, the period and the end date stated.
- Grey area: at connection, before she has seen what it pays for.
- Not OK: a standing allowance with no limit or no end date, or one preselected.
The allowance prompt
Tapping Set up opens Bitcoin SV Wallet's sheet: "Let The Satoshi Vision charge you up to 500 sats a day for articles", "about 25p", "Ends 24 November", "You can stop this at any time". Allow and Not now.
The allowance is small, capped by day, and expires, as Spending allowances recommends. The permissions standard counts a spending limit per calendar month, so the daily cap is Bitcoin SV Wallet's own policy on top.
Do
Give the allowance an end date in the request itself, and show that date on the wallet's sheet. When it ends, ask again and show what the last one was spent on.
Open questions
- Should connecting and the first payment be one wallet sheet or two? Two sheets for 1p is a lot of tapping; one sheet mixes a lasting grant with a single payment.
- Is 500 sats a day, for 30 days, the right first allowance for a reader who buys a few articles a day, or is it too large to feel safe?
- After "No thanks", should the offer come back on every later visit, after a number of paid articles, or never until the reader asks?
- Do readers expect the paywall to appear before or after the opening paragraphs?
- Does "about 25 articles" make the allowance easier to agree to, or does it read as a target?
Related
- Reading and the meter: what happens once the allowance is in place
- Connecting a wallet
- Permissions and allowances
- Pricing
Written from: /guide/patterns/connecting-a-wallet/, /guide/patterns/signing-in/, /guide/patterns/permissions-and-allowances/, /guide/patterns/charging-per-use/, /guide/product/pricing/, /guide/product/business-models/.
Checklist
The rules on this page, in a form you can work through.
11 rules