Skip to main content
Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.
Use the TypeScript helper in examples/agentcard to attach Agentcard’s Vault SDK to the dedicated context of a newly created Notte session.

​
Set up

Use Node.js 24+, a Notte API key, and sandbox credentials from the Agentcard dashboard. Follow the Vault quickstart to link a test card and obtain its user ID. Open examples/agentcard and run npm ci. Create an Agentcard client from @agent-cards/sdk, then pass it to runCheckout with your merchant, amount, currency, and user ID. Your application supplies three callbacks: purchase drives the merchant checkout, onApprovalUrl delivers the approval link privately, and readMerchantOrder checks the merchant’s order result. The SDK attaches before checkout actions run. Approval links and payment details must stay out of ordinary logs. Validate your merchant checkout in Agentcard sandbox before production. Approval alone does not confirm an order. The helper returns a status, optional confirmed order ID, and browser session ID. It attempts to close its page, browser connection, and session. If cleanup fails after reconciliation, it preserves the checkout result and adds a sanitized cleanup_errors list. Use the session ID to inspect and stop the owned session if needed; do not repeat the purchase. Follow up with the merchant when the outcome is unknown or needs user action. See Agentcard’s completion guide.