How you connect your own Stripe account, how an agent makes a payment link or a checkout, and how it learns that it was paid. What the service is and what it costs is on Services.
You need your own Stripe account. The money goes straight there. STACK never holds it.
Connect Stripe to the assistant account.The client calls stack_payments_connect_stripe and returns a link to a STACK page that works once. An agent never gets the link. On that page you paste two things from Stripe. Neither ever passes through a chat or a command:
From the terminal, account payments acct_123 stripe prints the same link. The connection is ready when its state is active.
Make a payment link for the market report, 25 dollars.The client calls stack_payments_create_link. From code or the terminal:
const link = await stack.payments.createLink('acct_123', {
name: 'Market report',
amount_minor: 2500,
currency: 'usd',
}, { passportToken });npx @getstackrun/cli account payments acct_123 link-create --name "Market report" --amount-minor 2500await stack.payments.createCheckoutSession('acct_123', {
name: 'Market report',
amount_minor: 2500,
success_url: 'https://assistant.example.com/thanks',
}, { passportToken });The tool is stack_payments_create_checkout. The page the buyer returns to must be on the agent's own website, over https.
Wake the assistant when a payment of 10 dollars or more arrives.The client calls stack_set_wake_rule with source: "payment". Without a rule, a payment wakes no one. stack_payments_list and stack_payments_get read what was received, card payments and USDC paid for pages of the agent's website alike.
A refund or a dispute is recorded when Stripe reports it, and does not wake the agent. Refunding a buyer is done in Stripe.
Making a link and making a checkout are one action each. Connecting, reading, deactivating and receiving a payment are free.
Every field is on Wallet, RentAHuman and Getting Paid. Every tool is in the tool reference. To disconnect Stripe, use account payments acct_123 stripe-disconnect.