Stripe
Read Stripe objects into a Strata flow. Oplema can't write to Stripe.
Before you start
- A Stripe API key. Use a restricted key (
rk_live_…orrk_test_…) with Read access to the objects you want. Oplema also accepts secret keys (sk_…), but those can do far more than reading. - A test key reads test data. A live key reads live data. The connection is labeled to match.
- Requests to Stripe come from Oplema's servers, not your browser. If your Stripe account restricts access by network, it must allow them. Oplema doesn't promise a fixed IP address; contact us if you need to allowlist.
Connect
- In Strata, select an Input block.
- Set Source to Connectors.
- In the connector dropdown below it, choose Stripe.
- Open the Connection dropdown and choose Create new connection.
- Enter your key in the field that shows rk_live_… or rk_test_…. The key is shown as you type.
- Set Name (optional). Without a name, the connection is labeled
Stripe liveorStripe test. - Select Save connection.
The new connection is selected. Saving only checks the format of what you typed. It doesn't sign in, so wrong details first show up as an error when the pickers below load.
A saved connection can't be edited. To change a password, token or any other field, open the Connection dropdown, choose Delete (the ×) on its row, and create the connection again. Blocks that used the deleted connection must then select the new one.
Read
| Setting | What it does |
|---|---|
| Object | Customers, Charges, Payment intents, Invoices, Subscriptions, Products, Refunds, Payouts, Balance transactions, Prices, Credit notes or Disputes. |
| Created from and Created to | Optional. Creation dates in UTC. Blank means no limit. |
| Status | For subscriptions, and for prices (Active or Inactive). |
| Load complete line items | For invoices, subscriptions and credit notes. Slower, because it fetches every line item. |
Select Refresh data to read again. Use Parse → JSON for nested details. Payment-intent client secrets are removed before the data reaches your flow.
Limits and billing
- Reads: the first 50 MB of each download is free. After that, each download costs $0.01 per GB from your usage. Failed reads aren't charged, and a read stops when your usage runs out.
- Rate-limited or failed requests are retried up to twice.
See Billing for who pays and how usage works.
Troubleshooting
| Message | What to do |
|---|---|
expected a Stripe secret or restricted key (sk_… or rk_…) | This appears when you save. Check you pasted the whole key. |
Stripe: cannot read <object> (HTTP 403); grant Read access to this resource on the restricted key. | Add Read access in Stripe. If this means a new key, delete the connection and create it again. |
Stripe: cannot read <object> (HTTP 401); replace the invalid or expired key. | Delete the connection and create it again with a new key. |
Stripe: missing or repeated record ID; refresh data | Select Refresh data. |
This transfer exceeds the free 50 MB and the available usage credits | The read passed 50 MB and your usage ran out. Add usage, or read less data. |
Prepare your data. Build it in Strata.
Strata opens in your browser, with no account.