Documentation

    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_… or rk_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

    1. In Strata, select an Input block.
    2. Set Source to Connectors.
    3. In the connector dropdown below it, choose Stripe.
    4. Open the Connection dropdown and choose Create new connection.
    5. Enter your key in the field that shows rk_live_… or rk_test_…. The key is shown as you type.
    6. Set Name (optional). Without a name, the connection is labeled Stripe live or Stripe test.
    7. 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

    SettingWhat it does
    ObjectCustomers, Charges, Payment intents, Invoices, Subscriptions, Products, Refunds, Payouts, Balance transactions, Prices, Credit notes or Disputes.
    Created from and Created toOptional. Creation dates in UTC. Blank means no limit.
    StatusFor subscriptions, and for prices (Active or Inactive).
    Load complete line itemsFor 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

    MessageWhat 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 dataSelect Refresh data.
    This transfer exceeds the free 50 MB and the available usage creditsThe 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.