Pay with Stripe Link

This page shows how to buy Uno Kit storage with a card through Stripe Link. It is for the owner of an App account who works in a terminal. The page is self-contained.

Stripe Link is the one card path. Agent accounts cannot use it. An Agent account pays with a Tempo wallet: see Pay with Tempo.

Before you start

Use an App account. Kit refuses Stripe settlement for an Agent account.
Install link-cli and connect a Link account. The Link reference lists link-cli onboard to connect an account and link-cli auth login to sign in: Link CLI reference.
Open an interactive terminal. The CLI starts Link only when you pass --method stripe, you are not in agent mode, you pass no --json or other format flag, and stdin and stdout are terminals.
Check that Kit offers Stripe. The offer appears only when Stripe is enabled for the purchase. Run the purchase without --method. When Stripe is offered, the exit 15 output names it, and in --json mode the offers are under error.details.payment.offers.

Amount and receipt

The amount is in USD.
The Stripe card minimum is USD 0.50, per the Stripe MPP page. The CLI treats an offer under that amount as unavailable.
A sandbox offer uses Link test mode.
The receipt reference is a Stripe PaymentIntent id, which starts with pi_.

Pay

Run the command that the exit 15 output prints. Keep its blocks, its explicit --renew or --no-renew, and its --operation.

uno kit pay --blocks 1 --renew --method stripe --operation purchase-1

Link asks you to approve the quoted USD amount. Approve it only if you want the storage.

On success, the result shows the PaymentIntent reference.

Do not combine --method stripe with --payment-file, --subscribe or --capacity. The CLI refuses each of them with a usage error. A Stripe credential in a payment file is also refused: rerun the original purchase with --method stripe.

What the CLI does with the payment token

The CLI hands Link a private, single-use route on 127.0.0.1. Link fetches the challenge from that route and returns its Payment header to it. The CLI forwards the header to Kit.

The Shared Payment Token (SPT) never appears in a command-line argument or in the CLI journal. The route accepts one POST, answers 409 after the first submission, and is closed when Link exits.

Recover a lost reply

If the reply is lost after the CLI submitted the payment, the CLI exits 7 and tells you to run uno kit resume. Run it with the same operation before you approve another payment:

uno kit resume purchase-1

Kit reconciles a pending Stripe attempt. It does not charge the purchase twice. If Kit cannot yet confirm the result, it answers that settlement is pending and asks you to recover the purchase before paying again.

Failures

Situation	Result
`link-cli` is not installed	Exit 15. Install and sign in, then run the same purchase
Link exits before it submits a payment	Exit 15. Review the offer and try again
Stripe is not offered for the purchase	Exit 21: "Stripe Link is unavailable for this purchase."
The terminal is not interactive	Exit 15. The CLI prints the command to run in a terminal
Stripe cancels or declines the payment	Kit refuses. Start a new purchase with a new `--operation`
Settlement is uncertain	Exit 7. Run `uno kit resume <operation>`