Integration guide

Stripe integration for AI agents and workflows

Swfte Studio has a Stripe node. Its shipped data shows three actions: list customers, create a customer and get the account balance. None of them moves money. A workflow built from these actions can look after customer records and report a balance, and a person can approve before it writes.

Stripe appears in the catalogue under finance-accounting and sales, and the MCP tool list has a Stripe server that asks for one value, STRIPE_API_KEY. This page does not claim support for charges, refunds, subscriptions or Stripe’s agentic commerce products, because none of them appears in the data.

Built in Swfte Studio, run as a governed workflow, and held to the same rules as any governed agent.

Stripe at a glance

Catalogue
Finance Accounting, Sales
Actions in the shipped data
3 (2 read, 1 write)
Credential type shown
stripeApi
MCP server
Stripe, needs STRIPE_API_KEY
Shipped templates that use it
Stripe Payment Workflow

What you can do with Stripe

Every action below is read from a node in a shipped workflow template. Nothing is listed that the data does not show.

Stripe actions in the shipped workflow templates
ActionTypeOperationWhat the data shows
List CustomersReadcustomer.getAllLists customers. The shipped template returns ten.
Create CustomerWritecustomer.createCreates a customer from an email address, with a name and a description.
Get BalanceReadbalance.getGets the account balance.

Two reads and one write, and the write creates a record and not a payment. Charges, refunds, payouts and subscriptions are not in the shipped data.

No Stripe event, such as a payment succeeding, is in the data: <Stripe trigger events - founder to fill>.

Money systems get the strictest version of every control

Stripe holds customer records, balances and, behind them, the ability to charge and refund. The key you give a workflow decides how far that reaches. A full secret key can do everything on the account, while a restricted key can be limited to the objects a workflow needs. For a workflow that lists and creates customers and reads a balance, a restricted key with those permissions and nothing else is the right starting point.

The shipped template’s description says it lists charges, but its nodes list customers, create one and read the balance. That is worth knowing: the data supports customer and balance work and does not support payment work. A test-mode key lets you rehearse every step with no real effect before you point the workflow at live data.

How to connect Stripe

The shipped template names the credential type stripeApi, and the MCP tool entry asks for STRIPE_API_KEY. In both cases the credential is an API key.

  1. 01

    Make a restricted key

    In Stripe, create a restricted key with read access to customers and the balance, write access to customers, and nothing else.

  2. 02

    Start in test mode

    Use a test key first and run every workflow against test data until the approver is happy with what they see.

  3. 03

    Store it once

    Add the key as a credential in Studio, and keep it out of workflow text, chat messages and prompts.

  4. 04

    Gate every write

    Put a human-input step before the create action, addressed to someone in finance operations.

Three governed Stripe workflows to build in Studio

Each has a label. A starting point builds on a shipped template, which is an integration test with no approval step. A design is intent only.

Customer record from an approved sign-up

Starting point

Builds on the shipped template “Stripe Payment Workflow” (6 nodes), which you can find in the template library.

Create a Stripe customer only after the account team confirms the details.

  1. A prepare step builds the customer from the sign-up fields.
  2. The list action checks for an existing customer with the same email address.
  3. A human-input step shows the details to finance operations.
  4. On approval, the create action adds the customer.

Where the approval sits. The shipped template creates its customer with no check. The duplicate check and the approval are the changes. Assign the gate to someone other than the person who made the request, because the platform does not check that for you.

Daily balance note for finance

Designed

Give finance a short note of the balance each morning.

  1. The get-balance action reads the balance.
  2. A code node formats the figure for a short note.
  3. If the balance is below a level your finance lead sets, a human-input step asks them to look.
  4. The note goes to the finance channel with the Slack post-message action.

Where the approval sits. The workflow only reads. The Slack channel should be limited to people who may see the balance.

Duplicate customer review

Designed

Find customers that look like the same person and let a human decide.

  1. List customers.
  2. A code node groups likely duplicates by email address and name.
  3. A human-input step shows each group to a finance owner.
  4. The decision is recorded, and merging is done in Stripe by a person.

Where the approval sits. Merging is not in the shipped data, so the workflow ends at the decision.

Shipped template
A governed template with its approval step already in it ships in the platform.
Starting point
A shipped template runs the same actions. It is an integration test with no approval step, so you add the gate.
Designed
Design intent. It uses the actions listed above plus generic nodes, and nothing has been built as a template.

Approvals and records for Stripe

Stripe is where a company’s money is held, so the bar for approval is lower than for most tools. Ask often.

Needs a person’s approval

  • Creating any customer record in live mode.
  • Changing the key, or the permissions it carries.
  • Adding any new action to a workflow that already runs in live mode.

Can run without one

  • Reading the balance for an internal note.
  • Listing customers in test mode.

What is recorded

  • Every Stripe action in a run, and the approval that came before each write.
  • The approver’s decision and the time of it.
  • The policy verdict taken before the action: allow, redact, ask or deny.

Segregation of duties is something you set up and not something the platform checks for you today, so assign the approval to a second person yourself. The human-input step, the policy engine and the run ledger are built. A single Trust Profile record for the workflow is designed for, and it is not built.

A policy step in a design below describes the intent. The policy engine acts only on runs that have a policy attached, and a self-serve way to author policies is not something we describe as built.

Swfte’s own security position and any attestations are on the trust page. How approvals, policy and records fit together is on the governed agents page.

Comparing tools for Stripe work

These comparison pages are dated and sourced. Each says who should pick the other tool.

  • n8n alternatives

    The n8n comparison covers hosting, approvals and audit for payment-adjacent automation.

  • Pipedream alternatives

    The Pipedream comparison covers developer-led automation, which is where many Stripe workflows begin.

  • Best automation platforms

    How automation platforms compare on governance, approvals and records, with the method shown.

Stripe questions

Can a Swfte workflow charge a card or issue a refund?

Not with the actions in the shipped data, which list customers, create a customer and get the balance. We do not claim charges or refunds on this page.

Does Swfte support Stripe’s agentic commerce products?

This page does not claim it. Nothing in the shipped data covers them, so we say no more than that until it is built and checked.

Which Stripe key should I use?

A restricted key with only the permissions the workflow needs, in test mode first. A full secret key can do everything on the account, which is far more than a customer and balance workflow requires.

Is there a Stripe MCP server?

Yes. The MCP tool list has a Stripe entry, described as a payment processing MCP server, and it asks for STRIPE_API_KEY. The tools it exposes are not in the data: <Stripe MCP tool list - founder to fill>.

Who should approve a Stripe write?

Someone in finance operations who is not the requester. The platform does not check that the two are different people, so assign the human-input step to the right person when you build the workflow.

Build a governed Stripe workflow

Begin with a read-only workflow on a test account, then add one write with an approval in front of it.

Build this in Studio

Describe what you need in plain language. Studio builds the agents and workflows, and you keep every version.