Webtron + Stripe

Accessing and Managing your Stripe API Keys

Estimated reading: 5 minutes

This guide covers how to create and generate a new Secret Key in Stripe specifically for use by Webtron’s new Bidder Verification module.

Stripe Account Required – This guide assumes you have already created a Stripe account and are ready to move on to this phase of the Bidder Verification setup. If you have not done so already, please create and and verify a Stripe account before proceeding with this guide.

Stripe Test Mode – In order for the Stripe Keys you provide us to work, you must turn disable Test Mode in your Stripe Dashboard if you haven’t already. Test Keys cannot be used in your Portal’s Live Environment, so please ensure Test Mode is not turned on before following this guide.

Generating and Copying your Stripe API Keys

As part of our Bidder Verification module, we’ll need valid Stripe API Keys:

  1. Your Public Key
  2. Your Secret Key

You’re limited to 1 Public Key active per Stripe account, but you can create new Secret Keys as needed, this guide details how to retrieve your Public Key, and create a new Secret Key inside the Stripe Dashboard.

Before we begin, please make sure you have access to the inbox of the email address you used to create your Stripe account. Stripe’s verification service will require you to follow a verification link, which must be opened in the same browser you are using to log in to the Stripe Dashboard.

Security Notice – Do not provide your Stripe API Keys to anyone outside your organisation. If you ever receive an email from us asking you to provide your API Keys again, immediately email us at support@webtronoa.com to verify this request. We will delete any emails containing your API Keys after the initial setup phase, and we heavily recommend you do the same.

Step 1 – Enabling the Stripe Developer Workbench

After logging into your Stripe account, you’ll land on the Stripe Dashboard Home page. Look to the top-right of the page and click on the Settings icon here:

This will open the Account Settings page, click on the top-right option labelled Developers, then tick the Enable Workbench checkbox at the centre of the page:

If this is your first time using the Workbench, you’ll need to set your Dark or Light mode and then click the purple Continue button. The Workbench will now pop up from the bottom of your screen:

Step 2 – Accessing and copying your Stripe Publishable key

Inside the Workbench, look to the top-left hand side of the Overview tab for the API Keys section. Click the purple Manage API key link to open the API Keys menu:

Inside the API Keys menu you’ll find two tables:

  1. Standard keys
  2. Restricted keys

Look inside the Standard keys table for the first row, labelled Publishable key. You’ll find your Publishable key under the column labelled TOKEN.

Hover the mouse cursor over the key, when a small Click to copy tooltip appears, left-click and your Publishable key will be added to your Clipboard:

After copying your Publishable key, paste it into a new email to us (support@webtronoa.com) and then return to Stripe to continue.

Step 3 – Creating and copying a new Stripe Secret key

After you’ve copy-pasted your Publishable key, return to the Stripe Dashboard and look to the right-hand side of the Standard keys table, then click on the + Create secret key button:

A panel will expand out from the right containing two options, tick the option labelled “Building your own integration” (the second option down), then click the purple Continue button at the bottom-right of the panel to proceed:

The Stripe Dashboard will now request you to verify your action via Email. In the centre of the “We’ll need additional information” panel, it will specify which email address will receive the Verification Link, click the purple Send verification button at the bottom-right of the panel to proceed:

Same Browser Session Verification – Stripe will require that the Verification Link is opened by the same browser you are currently using, so if this email account is accessed elsewhere, you will need to either sign in to that email account on the device you’re currently using, or restart the Create secret key process on the device currently logged into that email account.

After you’ve followed the Verification prompts, you should now see a “Create a new secret key” panel asking you to set a Key name, we recommend naming the new key “Webtron Bidder Verification“, then click the purple Create button to proceed:

You’ll now see a “Your new API key” panel containing your newly generated Secret key. Same as the Publishable key, float your mouse cursor over the key until you see the Copy to clipboard tooltip. Left-click to copy the Secret key, then press the Done button at the bottom-right of the panel:

Please send through that Secret key along with your Publishable key via email to us (support@webtronoa.com) at your earliest convenience.

Regenerating Keys Notice – Stripe gives you the option to Regenerate your Publishable and Secret keys, doing so will cause your Bidder Verification to go offline until we receive those updated keys. Please do not regenerate your Stripe API Keys without providing us with sufficient notice (48 hours) and only if absolutely necessary. We will organise a Google Meet with you to supervise, retrieve, implement and test the new API Keys to ensure the downtime for your Bidders is as brief as possible.

Contents