Stripe payment lifecycle evidenceCan make changes
Attach Stripe Payment to Invoice
Attach exactly one previously verified PaymentIntent or PaymentRecord to one invoice. Allocation and matching decisions remain in the workflow.
Stripe API transport for customers, invoices, payment lifecycle evidence, and balances. It contains no bookkeeping, collections, tax, or approval policy.
Connection facts
What the Stripe connector actually exposes.
These details come from the current StackOS provider manifest and action catalog. They describe the available connection—not a promise that every workflow will use every action.
- Connection method
- api-key
- Setup
- In the Stripe Dashboard, create a restricted API key with only the customer, invoice, invoice item, payment intent, payment record, charge, balance transaction, refund, and balance reads or writes required by your approved workflows. Connect it through StackOS; never share the key with an agent.
- Capability groups
- Stripe invoicing, Stripe payment lifecycle evidence
- Action boundaries
- 18 read actions8 write actions
Action catalog
Actions listed for Stripe.
Actions listed for this integration. Individual descriptions note availability limits. A workflow still decides which actions belong in the job and where approval is required.
26 matching actions
Stripe invoicingCan make changes
Create Draft Stripe Invoice
Create a Stripe draft invoice in the explicitly approved currency that will later be explicitly finalized and sent.
Stripe invoicingCan make changes
Create Stripe Customer
Create one Stripe customer from explicit approved details and return an account-bound customer reference.
Stripe invoicingCan make changes
Create Stripe Invoice Item
Add one explicit positive-amount line item to an explicit Stripe customer and draft invoice.
Stripe invoicingCan make changes
Finalize Stripe Invoice
Finalize one reviewed draft invoice with auto_advance=false; this does not send it.
Stripe payment lifecycle evidenceReads data
List Stripe Balance Transactions
Return one bounded Stripe balance transaction page with gross, fee, refund, and net evidence.
Stripe payment lifecycle evidenceReads data
List Stripe Charges
Return one bounded Stripe charge page and a safe continuation reference, optionally filtered by customer or payment intent.
Stripe invoicingReads data
List Stripe Customers by Exact Email
Return one bounded page of Stripe customers matching one exact email, so an existing customer can be used without a raw provider ID.
Stripe payment lifecycle evidenceReads data
List Stripe Disputes
Read one bounded dispute page for exactly one charge or payment intent; no evidence content or dispute mutation is exposed.
Stripe invoicingReads data
List Stripe Invoice Items
Read one bounded page of items for exactly one invoice or customer; descriptions are exact UTF-8 SHA-256 digests by default, with optional scoped business text.
Stripe payment lifecycle evidenceReads data
List Stripe Invoice Payments
Return bounded payment lifecycle evidence for one Stripe invoice. Missing or null payment linkage preserves facts and pagination but cannot establish a payment match or settlement.
Stripe invoicingReads data
List Stripe Invoices
Return one bounded Stripe invoice page and a safe continuation reference when more results exist.
Stripe payment lifecycle evidenceReads data
List Stripe Payment Records
Temporarily unavailable in StackOS while the documented Stripe PaymentRecord listing endpoint availability mismatch is resolved. Inspect retained action audit/response files and retrieve a known PaymentRecord ref; if the ref is missing, hold for owner/provider recovery and never create a replacement report.
Stripe payment lifecycle evidenceReads data
List Stripe Refunds
Return one bounded Stripe refund page for reconciliation evidence; this action never creates refunds.
Stripe payment lifecycle evidenceCan make changes
Mark Stripe Invoice Paid Out of Band
Mark one verified fully settled invoice paid without creating a Stripe charge. It is never a partial-settlement fallback.
Stripe payment lifecycle evidenceCan make changes
Report Verified Stripe Payment Record
Report one verified bank transfer with a fixed custom Bank transfer method and guaranteed outcome. The bank reference is materialized only for provider dispatch and is never returned.
Stripe payment lifecycle evidenceReads data
Retrieve Stripe Balance
Retrieve current available and pending Stripe balance buckets for cashflow evidence; it never moves funds.
Stripe payment lifecycle evidenceReads data
Retrieve Stripe Balance Transaction
Retrieve gross, fee, and net evidence for one previously discovered Stripe balance transaction.
Stripe payment lifecycle evidenceReads data
Retrieve Stripe Charge
Retrieve one previously discovered Stripe charge by its safe reference; optionally include its description, receipt link and safe customer reference for matching.
Stripe invoicingReads data
Retrieve Stripe Customer
Retrieve one previously discovered Stripe customer by an account-bound reference; optionally return reviewed name, email and description as sensitive business details.
Stripe payment lifecycle evidenceReads data
Retrieve Stripe Dispute
Read a previously discovered dispute by its account-bound reference, excluding submitted evidence and customer content.
Stripe invoicingReads data
Retrieve Stripe Invoice
Retrieve one invoice with its current customer expanded, primary email digests and observed due date. Optional business details include invoice number, memo, customer snapshot name/email and hosted invoice/PDF links; additional billing recipients remain outside API visibility.
Stripe payment lifecycle evidenceReads data
Retrieve Stripe Payment Intent
Retrieve verified PaymentIntent settlement evidence by an account-bound reference, excluding payment method, PII, metadata, and client-secret data.
Stripe payment lifecycle evidenceReads data
Retrieve Stripe Payment Record
Retrieve one reported PaymentRecord by an account-bound reference, exposing only settlement state, safe account references, and a bank-reference digest.
Stripe payment lifecycle evidenceReads data
Retrieve Stripe Refund
Retrieve one previously discovered Stripe refund; this action never creates a refund.
Stripe invoicingCan make changes
Send Stripe Invoice
Request a send for one already finalized Stripe invoice. Sandbox/test mode sends no email; an accepted test request is not sent/delivered. Live acceptance is not inbox-delivery proof. Workflow approval and exception policy remain outside the connector.
Direct answer
How does the Stripe integration work?
People continue using Stripe as their tool. StackOS adds it to a visible workflow, keeps the work in order, and passes only the approved action to the integration when that stage is ready.
- 01Your requestStart in your AI
- 02StackOS planExpands the steps
- 03StripeDoes its bounded part
- 04Checked resultKeeps the proof
Common questions
Stripe and StackOS.
What can the Stripe integration do in StackOS?
The current catalog includes 26 Stripe actions across Stripe invoicing, Stripe payment lifecycle evidence. The exact actions used depend on the workflow and approval rules.
Does StackOS replace Stripe?
No. Stripe remains the tool that performs its part of the job. StackOS organizes the workflow, keeps status and dependencies visible, and calls the tool only when the plan reaches the right approved action.