Stripe Integration

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.

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. After saving your branding information, scroll down to the Integration Section.
2. You will find the Client ID in this section.
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. This allows vendors to approve their Stripe accounts for payments.

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 URI 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.

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.