Adding API Keys

If you are using the ECOM Module in RocketFusion, you need to get the "test" and "live" API keys for the merchant gateway you intend to use. RocketFusion supports Stripe, PayPal, and Authorize.net.

All three merchant gateways use a pair of API keys (essentially account number and password) for both "test" and "live" mode. We generally set up test keys first and run a few fake purchases to make sure the gateway is working, then flip to live mode.

Getting Ready to Copy / Paste the API Keys

RocketFusion has a "settings" page that can show all settings for every module as well as other aspects of your website. We will focus on the ECOM Module settings, here.

• First off, of course, log into your website as the administrator.
• Mouse-over the rocket icon in the very top left of your screen to get to the Admin Panel
• Click on Site Settings, down near the bottom
• Click on ECOM in the first column of links
• In the list of settings, you'll want to focus on the ones shown in the image on this page:
  • Ecom Merchant (Stripe, PayPal, Authorize.net)
  • Ecom Merchant Mode (Live, Test)
  • Ecom Merchant Live Key 1 and 2
  • Ecom Merchant Test Key 1 and 2
• For Ecom Merchant, choose the gateway you're going to use
• Set Ecom Merchant Mode to Test for now
• Copy and paste the API Keys (see below) to Live and Test Key 1 (public key / account) and Key 2 (secret key / password)

Obtaining PayPal API Keys

PayPal allows for the use of API keys only on Business accounts. If you are using a Personal account you will likely need to upgrade your account to Business, which is also free.

• In a new browser tab, go to PayPal.com and log in using your regular username (email address) and password
• From the Homepage on PayPal, click the Developer link on the top right
• Mouse-over your name on the top right and click My Account
• On the left side bar, click the top link My Apps & Credentials
• Click the white "Live" link in the pill near the top of the page
  • Alternatively, you can also create a "Sandbox" set of keys for testing while we're still working on your site
  • If you do create a sandbox set of keys, paste them into the Ecom Merchant Test Key 1 & 2, below
• Click the blue Create App button
  • Enter "RocketFusion API" in the App name field, then click the blue Create App button
  • On the next page you will be presented with the Client ID. Copy that string to your clipboard
• Return to the browser tab with your website
  • Make sure you're still on Admin Panel > Site Settings > Ecom
  • Scroll down to Ecom Merchant Live Key 1 and paste the string in
• Click back to the browser tab for PayPal
  • Click the "Show" link under Secret:
  • Copy the secret string to your clipboard
• Click back to the browser tab with your website
  • Paste the string into Ecom Merchant Live Key 2
• Scroll up near the top of this page and ensure Ecom Merchant is set to PayPal

Obtaining Stripe API Keys

• Go to Stripe.com and log in
• Click Developers on the left
• Click API keys
• There are two types of keys: Test, and Live. There is a switch on the right "View test data" to switch between the two.
  • Your website has a place for both test and live key pairs
  • Enter in both pairs and set your website to be in Test mode until a few test purchases have been created
• We use standard Keys
• If you don't already have a Publishable key, click Create secret key button
• If you do, copy the Publishable key and paste into appropriate Key1 field on your website
  • You can also click the "Reveal [live/test] key token" button to the appropriate Key2 field on website
• You will also need to associate certain special settings with a special URL:
  • charge.failed
  • charge.succeeded
  • checkout.session.completed
  • invoice.payment_succeeded
  • https://[your-website-domain-name]/webhooks/stripe.cfm

Obtaining Authorize.net API Keys

• Log in to Authorize.net
• Click on Account on the right
• In the set of links, click on API Credentials & Keys
• Copy the API Login ID and paste into Live Key 1 on your website
• Check "New Transaction Key" and then check the Delete Old if it appears
  • You may be challenged by a pin verification email sent to the email account on record
• Once you have the Transaction Key, past that into Live Key 2 on your website
• Save changes