Stripe Connect integration allows you to transfer money from the merchant account to the vendor account seamlessly within ShipTurtle. This enables easy and automated payments to vendors, making the payout process efficient and straightforward.

This guide will walk you through the process of integrating Stripe with ShipTurtle.

1) What You Need for Stripe Integration

To integrate Stripe with ShipTurtle, there are two main requirements:

1. Merchant's Stripe Account: The merchant (you) will need a Stripe Connect account to initiate payments.
2. Vendor's Stripe Account: Each vendor in your marketplace must have a Stripe account to receive payments.

2) Steps to Integrate Stripe in ShipTurtle

Step 1: Create a Stripe Account and Get the Secret Key

1. Create a Stripe Account:
   Go to the Stripe Dashboard and create a Stripe Connect account for your marketplace.
2. Get the Secret Key:
   After logging into your Stripe account, navigate to:
3. • Developers → API Keys
   • Copy the Secret Key, as you will need this to complete the integration with ShipTurtle.
     [Please enter a valid Stripe secret key (starts with sk_). DO NOT use restricted keys (starting with rk_)].

Step 2: Set Up Stripe Connect Settings

To enable payment transfers to your vendors, you need to set up Stripe Connect within your Stripe account.

1. Go to Stripe Settings:
   Log in to your Stripe Dashboard, then go to Settings.
2. Click on Get Started:
   In the Connect box, click Get Started to begin the setup process.
3. Choose Platform or Marketplace:
   Select the Platform or Marketplace option in the pop-up, then click Continue.

Step 3: Save Branding Information

• You need to provide branding information during the setup process.
• Branding info is compulsory for Stripe Connect to work. Without it, Stripe will give an error, and you won’t be able to complete the setup.

Important:

• Select the Brand and Accent color for your marketplace as part of the branding process.

Step 4: Get the Client ID

1. From your Stripe Dashboard, navigate to:
   Settings → Connect → Onboarding Options → OAuth.
2. You will find the Client ID in this section.
   [Please enter a valid Stripe client ID (starts with ca_)].
3. Copy the Client ID, as you will need this for ShipTurtle configuration.

Step 5: Add Callback URL (Redirect URI)

To complete the vendor approval process, you must set up a Redirect URI (Callback URL) for Stripe.

1. Click the Add URI button.
2. In the pop-up, paste the following URL:
3. • Standard URL: https://app.shipturtle.com/app/settings/general/stripe-payment-approval
   • For White-Labelled Domains:
     If you're using a white-labeled version of ShipTurtle, replace the domain part of the URL with your own. For example:
   • • If your whitelabeled domain is https://vendors.abc.com, the URL will be:
       https://vendors.abc.com/app/settings/general/stripe-payment-approval

3) Configure Stripe in ShipTurtle

After completing the setup in Stripe, you can now integrate Stripe with ShipTurtle.

1. Log in to your ShipTurtle account.
2. Go to Settings → Multi-Vendor Settings → Payment Integration.
3. Click on the Plus (+) icon to add a new payment method.
4. Select Stripe as the payment gateway.
5. Paste the Client ID and Secret Key you obtained from Stripe.
6. Click Save.

Once connected, the status will show as “Connected” on the payment integration listing page.

Success!

• Your Stripe integration is now complete.
• All vendors selling on your marketplace will be able to receive payments via Stripe.

4) What Happens Next?

Once the integration is set up, Stripe payments will be available for your vendors. Payments will be processed automatically through Stripe, and vendors will be paid directly to their Stripe accounts.

5) Troubleshooting

Authorization Errors

If you encounter authorization errors during payment processing, ensure that:

• You have completed all branding information in Stripe.
• The Redirect URL is set correctly.
• Your Stripe account is fully configured and has no outstanding issues.

Summary

• Step 1: Create a Stripe Connect account and get your Secret Key.
• Step 2: Set up Stripe Connect in your Stripe Dashboard.
• Step 3: Save branding information and get your Client ID.
• Step 4: Set the Redirect URI for vendor approval.
• Step 5: Configure Stripe in ShipTurtle by adding the Client ID and Secret Key.
  

Stripe Account Connection for Vendors

This guide explains how vendors can connect their Stripe account to a merchant’s marketplace and how to resolve common setup issues.

How Stripe Connection Works

• When a merchant connects their Stripe account, a temporary vendor account is automatically generated.
• Vendors must use the link (Click here to connect stripe account) to complete their Stripe account setup.
• Once the onboarding process is completed, the vendor’s Stripe account is successfully connected to the merchant’s marketplace.

Steps for Vendors to Connect Stripe

1. Log in to the vendor dashboard
2. Navigate to:
   Settings → Vendor Profile → Payment Integration
3. If the merchant has already enabled Stripe, the Connect Stripe option will be visible by default
4. Click on Connect Stripe
5. Complete the onboarding process on Stripe
6. Once completed, the account will be successfully linked

Important Notes

• The Stripe onboarding link is single-use only
• If the link:
• • Does not work, or
  • Redirects back to Shipturtle

Refresh the page to generate a new onboarding link and restart the setup process.

Troubleshooting

• Always use the latest generated onboarding link
• Do not reuse expired or previously used links
• Complete the onboarding process in one session to avoid interruptions

Once connected, Stripe payments will be available for your vendors, ensuring seamless payouts directly through the platform.

If you’re stuck, reach us at team@shipturtle.com or open a ticket on the support page.