Riverr

task

Adding Your Stripe API Keys

Last updated July 28, 2026

Adding your Stripe API keys lets the platform charge customers through your Stripe account — including sending Stripe invoices on quotes and sales orders.

You'll need two values from Stripe:

  • Your Production (publishable) key — begins with pk_live_
  • Your Secret key — begins with sk_live_

> Note: This is separate from Stripe Connect payout setup. See Setting Up Stripe Connect for Payouts if you haven't done that yet.

Audience: Big Frog users connecting Stripe for payments

Estimated time: 10 minutes

Before you start: creating a Stripe account

If you don't have a Stripe account, go to stripe.com and sign up. You'll provide business and personal details as part of registration.

Two things to know before collecting keys:

  • Your account must be activated to move real money. Live-mode keys only work once Stripe has verified your business details.
  • You need Administrator permissions to view API keys. If you're on someone else's Stripe account without them, ask an administrator to grant access or supply the keys.

Step 1 — Find your keys in Stripe

  1. Log in at dashboard.stripe.com.
  2. Click Developers, then select API keys.

(You can also search "API keys" in the dashboard search bar to jump straight there.)

  1. Make sure you're in live mode, not test mode. Use the test-mode toggle at the top of the dashboard — with test mode off, the page shows your live keys.

Confirm you're looking at the right keys by their prefix: live keys start with pk_live_ and sk_live_. Test keys start with pk_test_ and sk_test_.

Step 2 — Copy your publishable key

On the API keys page, copy the publishable key for live mode. It's visible on the page and can be copied any time.

Step 3 — Copy your secret key

If a live secret key already exists, reveal and copy it. If not, click Create secret key.

> ### ⚠️ Live secret keys are shown only once

>

> For security, Stripe displays a live secret key a single time, right after it's created. Copy it immediately and store it somewhere safe.

>

> If you lose it, you can't recover it — you'll need to roll the key or delete it and create a new one.

Keep your secret key private. It has full access to your Stripe account, including charges and refunds. Never share it, post it publicly, or put it anywhere customer-facing.

Step 4 — Add the keys to your account

  1. From your dashboard, click Settings.
  2. Scroll down to Integrations.
  3. Find the Stripe section with the API key fields.
  4. Paste in your Production key and your Secret key.
  5. Click Save.

Once saved, Stripe is connected and ready to use.

Quick checklist

  • [ ] Stripe account created and activated
  • [ ] Dashboard set to live mode (not test)
  • [ ] Publishable key copied (pk_live_)
  • [ ] Secret key copied and stored securely (sk_live_)
  • [ ] Both pasted under Settings → Integrations
  • [ ] Saved

Troubleshooting

Problem What to do
Payments aren't processing for real You likely saved test keys — confirm both begin with pk_live_ and sk_live_
Can't see the secret key Live secret keys display only once. Create a new one, or roll the existing key.
No API keys option in Stripe You need Administrator permissions on the Stripe account
Live keys won't work Your Stripe account may not be fully activated — complete Stripe's verification
Key won't save Re-copy it, checking for extra spaces at the start or end

Related articles

  • Setting Up Stripe Connect for Payouts
  • Working with Quotes (Stripe enables invoicing and automatic charges)