Stripe
Keep Stripe in step with your orders, invoices and payments without re-keying, with the right person approving what changes.
50 ways to read, 16 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Stripe, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create couponApproval by rule
- Create customerApproval by rule
- Get balance transactionRead
Example flow
- Stripe · Get balance transactionDone
- Stripe · Create couponNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Stripe.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Stripe
- Stripe's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a Stripe test account before you go live.
For developers
Technical detail
Read and search Stripe billing, payment, balance, event and reporting data, and write customers, products, prices, coupons and draft invoices.
Stripe API docs- Source actions
- 50
- Destination actions
- 16
- Data types
- 24
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Balance transactions2
- Get balance transactionSource
One balance movement with fee breakdown. Read only.
- List balance transactionsSourceIncremental
Balance movements with fees and net amounts for reconciliation. Read only.
Balance1
- Get balanceSource
Available and pending funds by currency. Read only.
Charges3
- Get chargeSource
One charge with outcome and refund state. Read only.
- List chargesSourceIncremental
Charges with outcome, refunds and dispute flags. Read only.
- Search chargesSource
Charges by customer, status, currency, amount, dispute or refund state, creation date and metadata. Read only.
Checkout sessions2
- Get Checkout SessionSource
One Checkout Session. Read only.
- List Checkout SessionsSourceIncremental
Hosted Checkout Sessions with status, totals and resulting objects. Read only.
Coupons3
- Create couponDestinationProvider duplicate protectionApproval before production
Creates a percentage or fixed-amount coupon.
- Get couponSource
One coupon with discount, duration and redemptions.
- List couponsSourceIncremental
Coupons with discount, duration and redemption counts.
Credit notes2
- Get credit noteSource
One credit note. Read only.
- List credit notesSourceIncremental
Credit notes issued against invoices. Read only; credit notes are never issued.
Customers6
- Create customerDestinationProvider duplicate protectionApproval before production
Creates a customer record. No payment method is attached and nothing is charged.
- Get customerSource
One customer by Stripe ID.
- List CustomersSource
List operation for Customers.
- Search customersSource
Customers by metadata (for example an external ID) and creation date. Email, name and phone are not searchable here because Stripe search sends the query in the URL.
- Update customerDestinationProvider duplicate protectionApproval before production
Updates a customer by Stripe ID. The built-in adapter keeps email-matched upsert.
- Upsert CustomersDestinationNexra idempotency keyApproval before production
Upsert operation for Customers.
Disputes2
- Get disputeSource
One dispute with evidence deadline. Read only; evidence is never submitted.
- List disputesSourceIncremental
Chargebacks and inquiries with reason, status and evidence deadline. Read only.
Draft invoice items1
- Add item to draft invoiceDestinationProvider duplicate protectionApproval before production
Adds a line to a specific draft invoice using an amount or a price. Stripe rejects items for invoices that are no longer drafts.
Events2
- Get eventSource
One event from the last 30 days.
- List eventsSourceIncremental
Account events (object created, updated, paid and so on) for incremental change capture. Stripe keeps events for 30 days.
Invoice finalizations1
- Finalise draft invoiceDestinationProvider duplicate protectionApproval before production
Finalises a draft invoice so it can be paid or sent. auto_advance=false keeps Stripe from collecting or emailing automatically.
Invoice items4
- Create invoice itemDestinationProvider duplicate protectionApproval before production
Adds a charge line to a draft invoice or the customer's next invoice, using an amount or a price.
- Get invoice itemSource
One invoice item.
- List invoice itemsSourceIncremental
Invoice items, including pending items not yet on an invoice.
- Update invoice itemDestinationProvider duplicate protectionApproval before production
Updates an invoice item while its invoice is still a draft.
Invoices5
- Create draft invoiceDestinationProvider duplicate protectionApproval before production
Creates a draft invoice with auto_advance=false; add invoice items, then finalise it separately.
- Get invoiceSource
One invoice with totals, status and the first page of lines.
- List invoicesSourceIncremental
Invoices with totals, status and the first page of lines.
- Search invoicesSource
Invoices by customer, subscription, status, number, currency, total, date and metadata.
- Update draft invoiceDestinationProvider duplicate protectionApproval before production
Updates a draft invoice. Finalised invoices accept only limited changes.
Payment intents3
- Get payment intentSource
One payment intent. Read only; never confirmed or captured.
- List payment intentsSourceIncremental
Payment intents with amount, status and latest charge. Read only.
- Search payment intentsSource
Payment intents by customer, status, currency, amount, date and metadata.
Payment links2
- Get payment linkSource
One payment link. Read only.
- List payment linksSource
Shareable payment links. Read only.
Payouts2
- Get payoutSource
One payout. Read only.
- List payoutsSourceIncremental
Payouts to external bank accounts. Read only; payouts are never created.
Prices5
- Create priceDestinationProvider duplicate protectionApproval before production
Creates a one-time or recurring price for a product.
- Get priceSource
One price.
- List pricesSourceIncremental
One-time and recurring prices.
- Search pricesSource
Prices by product, lookup key, type, currency, active flag and metadata.
- Update priceDestinationProvider duplicate protectionApproval before production
Updates the mutable fields of a price.
Products5
- Create productDestinationProvider duplicate protectionApproval before production
Creates a catalogue product.
- Get productSource
One catalogue product.
- List productsSourceIncremental
Products in the catalogue.
- Search productsSource
Products by name, active and shippable flags, and metadata.
- Update productDestinationProvider duplicate protectionApproval before production
Updates supplied fields on a product.
Promotion codes2
- Get promotion codeSource
One promotion code.
- List promotion codesSourceIncremental
Customer-facing codes for coupons, with restrictions and redemptions.
Refunds2
- Get refundSource
One refund. Read only.
- List refundsSourceIncremental
Refunds issued in Stripe. Read only; refunds are never created.
Report runs2
- Get report runSource
One report run with status and result file.
- List report runsSourceIncremental
Financial report runs and their CSV result files. Read only; runs are not started.
Subscription items2
- Get subscription itemSource
One subscription item.
- List subscription itemsSource
Items of one subscription with price, quantity and billing period.
Subscriptions5
- Create subscriptionDestinationProvider duplicate protectionApproval before production
Creates a subscription with payment_behavior=default_incomplete; the first invoice's payment is not attempted by this request.
- Get subscriptionSource
One subscription with items, status and current period.
- List subscriptionsSourceIncremental
Subscriptions with items, status and current period.
- Search subscriptionsSource
Subscriptions by status, creation or cancellation date, and metadata.
- Update subscriptionDestinationProvider duplicate protectionApproval before production
Changes items, quantities, cancellation at period end, collection or metadata. Proration never invoices immediately.
Tax rates2
- Get tax rateSource
One tax rate.
- List tax ratesSourceIncremental
Manually configured tax rates applied to invoices and subscriptions.
Access and limits
- Authentication
- Stripe secret or restricted API key
- Plans and access
- All Stripe accounts. Use a restricted key with read access to billing, payments, balance, disputes, events, Checkout, payment links and reporting, and write access only to customers, products, prices, coupons and invoices.
- Test environment
- Test-mode keys and Stripe sandboxes behave like live mode without moving money.
- Rate limits
- 100 read and 100 write operations per second in live mode (25 each in test mode); HTTP 429 when exceeded.
- Pagination
- Cursor pagination with starting_after and has_more; up to 100 objects per page.
- Provider events
- Stripe webhook endpoints deliver signed events for every object type. Flows can start the moment something happens: when a checkout is completed; when a payment succeeds; when a payment fails; when an invoice is paid.
Before you build a flow
- Customer reads and email-matched upsert implemented. Concurrent creations require reconciliation.
- Payment intents, charges, balance transactions, refunds, payouts and disputes are read only. Charges, refunds, payouts and transfers are never created.
- Draft invoices are created and finalised with auto_advance=false, so Stripe does not automatically collect or email them.
- Subscriptions are created and updated with payment_behavior=default_incomplete and without always_invoice proration, so no payment is attempted automatically by these requests.
- Incremental reads filter on creation time; Stripe list endpoints have no updated-since filter. Use events.list (30-day retention) to capture updates to older objects.
- Search operations use Stripe's search API (https://docs.stripe.com/search): filters are validated and quoted, at least one is required, and at most 10 are combined with AND. Email, name, phone, billing postcode and card fields are never searchable because the query travels in the URL; use customers.upsert (built-in, email in the request body) or metadata instead.
- Search data can lag writes by up to a minute, is limited to 20 requests per second and is not available to businesses in India.
- Not implemented by design: charges, PaymentIntent confirm or capture, refunds, payouts, transfers, top-ups, Treasury money movement, subscription cancellation, invoice finalise, pay, send, void or mark uncollectible, credit note issue or void, report run creation, Checkout Session and payment link creation, and every delete.
- Balance and report-run reads need the Balance and Reporting permissions on a restricted key; report result files are downloaded from files.stripe.com with the same key and are not fetched by Nexra.
- Stripe does not charge per API request, so no operation is billable.
Developer reference
- Create the Stripe credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Stripe, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/stripe and the Connections API.