Skip to main content
This walks through the happy path end to end: link an agent, create a payment session, enter a card, and complete a purchase. Every command and output below is exactly what the CLI prints.
Steps marked You are done by the account owner (a human, in a browser). Everything else is run by the agent (or you, at a terminal).

Prerequisites

The CLI prints a link and exits immediately:
You: open that URL, sign in, and click Approve. Then wait for the approval to land:
Run prava status any time to confirm the agent is linked and active.

2. Create a payment session

You know the merchant and items, so create a session for the exact order:

3. Enter the card

You: open the Payment URL, enter your card in Prava’s secure page, and confirm. Meanwhile, the agent waits for the card to be tokenized (swapped for a one-time card number and code that stand in for the real card):
These credentials are single-use and short-lived: use them right away to complete the checkout. Don’t store or reuse them.

4. Complete the checkout

Use the token and cryptogram at the merchant’s checkout to finish the purchase. If you’re using agentic shopping (Prava discovered the product), the last step is a single command:
That’s the whole loop. 🎉

Where to go next

Linking an agent

The full linking lifecycle, platforms, and status states.

Payment sessions

Every flag for sessions create and sessions poll.

Agentic shopping

Search, compare, quote, and pay: the discovery flow.

Troubleshooting

What each message means and how to recover.