Linking Stripe with your microsite
You can collect payments straight into your Stripe account by linking it with your microsite following these steps.
There are two ways of linking your Stripe account to Emma:
1. Stripe (Direct Stripe OAuth integration) - allows you to securely connect your Stripe account without sharing its API keys.
Within Emma:- Navigate to the left hand menu: Account > Payment > choose Stripe (Direct Stripe OAuth integration) > click Next

-
- A Stripe pop-up appears prompting you to log into your Stripe account
- Once logged in, choose the account you want to link to and click Connect
- Once verified, you will be redirected back to Emma after the successful integration
*To perform this integration you require an Admin permission as a user in your Stripe account, as the next screen will take you to log in.
If you do not have this permission in Stripe, please add a user to Emma that does, and ask them to perform this process.
2. Stripe (Direct Stripe keys integration) - allows you to integrate directly by adding the Stripe API keys to your Emma account.
- Within Emma:
- Navigate to the left hand menu: Account > Payment > choose Stripe (Direct Stripe keys integration) > click Next.

- Within your Stripe account:
- In the search bar of your Stripe Account search for ‘API’
- Click on ‘Developers > API keys’ option
- The page below will appear

-
- Click on the long key to copy the Publishable (Live) key
- Now paste it into the 'Stripe Publishable Key' field in Emma.

-
- Choose Providing this key to another website
Add the Name as Emma Live and the URL as emma-live.com and click Create restricted key

Copy the restricted key so you are ready to paste it into the Emma field in a future step
*The restricted key can only be copied in full once when you create it.
You will now need to update the permissions for the restricted key from your Stripe Account.
- Click on the three dots ‘…’ next to the restricted key
- Click Edit key
- In the permissions column, change all the section headings with bold font and light grey/blue background to 'Write' e.g. Core (see screenshot below as an example)

Note: These keys can only be used to receive funds so are not as sensitive as they appear. By updating the section header, all the additional rows in that section below it will also update automatically - saving you time!
- Click the apply changes red button.
- Paste the restricted key into the Stripe Secret / Restricted Key field in Emma
- Click Verify.
- You will then see a pop up confirming the Stripe account name that your Emma account is now linked to.
- Finally, click Save.