How do I set up Stripe as my payment gateway?

As a vendor, you can connect with over 50+ Gateways of your choice on Ribbon to fit with your workflow. Here's a list by country. This article will show you how to add Stripe as your gateway.
While Stripe is included base price, the other Gateways do incur an additional monthly fee. If you have a Gateway that is not included in the supported Gateways, please inquire with the sales team for a custom integration. 

Requirements

Before getting started, ensure you have:

• An active Stripe account.

• Admin access to your MeetRibbon account.

---

Common errors when connecting to stripe

• Don't use a publishable key
• Create a new key (select Roll Key on the menu)
• You can find information about Restricted Keys on this page https://stripe.com/docs/keys

Step 1: Generate a Restricted API Key (RAK)

1. Log in to Your Stripe Dashboard:
   Go to https://dashboard.stripe.com and sign in with your credentials.

2. Search for API Keys:

   • In the top search bar, type "API".

   • Click on Developers > API keys from the dropdown menu.
     
     
     
     

3. Create a Restricted API Key:

   • Click + Create restricted key in the Restricted keys section.
     
     
     
     
     

4. Select How You Will Use the API Key:

   • Choose Providing this key to another website.
     
     
     
     

5. Enter Website Details:

   • In the Name field, enter the third-party name (e.g., Shoppe Object).

   • In the URL field, provide the link to the third party you're using (e.g., https://shoppeobject.meetribbon.com/).

   • Check the box Customize permissions for this key.

6. Set Permissions:
   
   Assign Write access to the following permissions by selecting Write next to each:

   • Charges

   • Customers

   • PaymentIntents

   • PaymentMethods

   • SetupIntents

   • Tokens

   • Webhook Endpoints

   
   
   ⚠️ Note: Depending on your Stripe account, these permissions may already be set to Write. Always confirm that all permissions are correctly set to Write before proceeding. This ensures smooth transactions and prevents verification issues.
   
   

7. Save Your API Key:

   Click Continue, then copy the Restricted API Key (RAK) and store it securely. You’ll need this for the next step.
   
   ⚠️ Important: Do not share your API key publicly. Treat it like a password.
   
   

Step 2: Connect Stripe to MeetRibbon

1. Sign in to your MeetRibbon dashboard.

2. Navigate to Payment Methods.

   • Select your Country

1. Add Your API Key:

   • Select Stripe as the payment provider.

   • Paste the Restricted API Key (RAK) into the API key field.

1. Save Changes:
   Click Save to apply the payment gateway settings.

Troubleshooting

• Error Messages: Check for permission errors in Stripe’s dashboard.

• Payment Failures: Confirm that all required permissions are set to Write.

• API Key Issues: Verify the key hasn’t expired or been revoked.
  
  

---

Need Assistance?

If you need help, contact our support team at [e-mail] for assistance.

•