DOCUMENTATION

Integrating with Stripe

How we wire your agent into Stripe so it can take payments, look up subscriptions, send invoices, and handle billing questions safely. Part of the Integrations section of the TrainYourAgent documentation, written to be executed against rather than skimmed.

What the agent can do

Once connected to Stripe, your agent can do four things on your behalf. It can charge a card or take a payment using a secure payment link generated on the fly during the conversation. It can look up an existing customer or subscription and answer questions about plan, next billing date, or last payment. It can send a Stripe-hosted invoice for a specific amount with a memo line tied to the conversation. It can issue…

What you need to provide

You need a Stripe account in good standing and a restricted API key with the right scopes. We will send you a short list of the exact scopes to enable inside the Stripe dashboard, typically read access to customers and subscriptions, write access to payment links and invoices, and limited refund permissions. We never need your full secret key. Generating a restricted key takes about three minutes inside Stripe's dashboard. We also need to know…

How payments work in a conversation

A typical payment conversation goes like this. The agent confirms what the customer wants to buy and the amount. The agent confirms the customer's email. The agent generates a Stripe payment link tied to that customer and that exact amount, sends it via SMS or email, and waits up to two minutes for the payment webhook to confirm completion. Once the webhook fires, the agent confirms the payment back to the customer and moves on.…

Refunds and disputes

For refunds, you set a maximum amount the agent can refund autonomously — typically one to two hundred dollars. Anything above that limit gets routed to a human. The agent never handles dispute responses directly because those carry legal and reputational risk that should always stay in human hands.

Section context

This article is part of the Integrations section. How we wire your agent into Stripe so it can take payments, look up subscriptions, send invoices, and handle billing questions safely.