> For the complete documentation index, see [llms.txt](https://enginethemes.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enginethemes.gitbook.io/docs/freelanceengine/fre-main-steps-to-set-up-the-site/fre-set-up-stripe-escrow-system.md).

# FrE Set up Stripe Escrow System

#### Stripe Escrow User Guidance

Regarding the popularity of Stripe transactions, Stripe for Escrow is released to meet our customer demands and gives a hand to the product growth. Stripe for Escrow is also similar to PayPal for Escrow. It helps transactions among admin, freelancers and employers work smoothly with Stripe combined with Escrow system. Let’s take a look below for detail information and step-by-step instruction.

#### Requirements

* This feature is currently available if your marketplace is located in these countries:

Please click here for more information about  [Countries and currencies supported by Stripe.](https://stripe.com/global)

* The recipient’s bank account (freelancer) also must be in the mentioned countries.
* When sending to a debit card, transfers must be less than $3000 (This card must be a Visa or Master card).

#### Workflow

The Escrow system will start working as soon as the employer accepts a bid. The process will work step by step like below.

<figure><img src="https://1999284333-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff7tDidpsIezjbEriksOY%2Fuploads%2FwkbsYXLHyQ8qdFSfRuha%2FNew-Mockup-1-920x828.png?alt=media&amp;token=56abfe83-701d-45e6-92f1-e903091a4b2e" alt=""><figcaption></figcaption></figure>

* Step 1: When Employer accepts a bid, he will pay the bid budget (example: $10) to Admin’s Stripe account.
* Step 2: After Employer accepts a bid, this project will change its status to “Processing”. If the employers “**FINISH**” this project, the Escrow process will move to step 3. Otherwise, the employers “**CLOSE**” or freelancers “**QUIT**” this project, it will turn the status into “dispute” and Escrow process will jump to step 4.
* Step 3: After the employer clicks “**Finish**” button, this project’s status will become into “Completed”.
* Step 4: The freelancer and employer will send their reports to Admin, and Amin will decide who the winner is in this case.

### How to Set up?

**Configure Stripe API on Admin setting page.**

Before you start, please make sure you have updated your Stripe’s profile (approved application) at:  <https://dashboard.stripe.com/account/application/settings>

Please navigate to  **Dashboard → Engine Settings** → **Escrow** → **Gateways** → **Stripe**&#x20;

<figure><img src="https://1999284333-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff7tDidpsIezjbEriksOY%2Fuploads%2F7rWFallYuzUsvMVp1H3k%2FScreenshot_94.png?alt=media&amp;token=173917b7-66f1-4366-832e-c3625e9d0c86" alt=""><figcaption></figcaption></figure>

(1) Enabling this allows you to use Escrow Stripe system on your site.

(2) Fill in:  **Your Stripe client public key (Publishable key)** and **Your Stripe client** **Secret key (Secret key)**. You can get it by going to: [https://dashboard.stripe.com/account/apikeys](https://dashboard.stripe.com/)

Note: Don’t forget to turn on  **Viewing Test Data** option.

<figure><img src="https://1999284333-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff7tDidpsIezjbEriksOY%2Fuploads%2F3Mo724YOKFjnCObTaOoE%2FScreenshot_95.png?alt=media&amp;token=c7937d02-a850-481a-9b69-3c4e99f6e609" alt=""><figcaption></figcaption></figure>

(3) You can get  **Stripe Client ID** by going to:&#x20;

<https://dashboard.stripe.com/test/settings/connect/onboarding-options/oauth> as the photo below:

<figure><img src="https://1999284333-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff7tDidpsIezjbEriksOY%2Fuploads%2FLrMsKHbVQvtxBWaYxhMX%2FScreenshot_96.png?alt=media&amp;token=db668871-1ce0-4c3b-b81b-e756f0fc1636" alt=""><figcaption></figcaption></figure>

In this section, you can get **Live mode client ID** or **Test mode client ID** , setting OAuth settings and config Redirect URI for your website.

Please ensure Enable OAuth Settings turn on.

You also need to **Add redirect URL:**

The form of redirect URL:   <https://yourdomainname.com/profile/>

<figure><img src="https://1999284333-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff7tDidpsIezjbEriksOY%2Fuploads%2FqUxFg6afj9wgWPwdpETQ%2FScreenshot_98.png?alt=media&amp;token=8deabac0-f533-401c-be43-0307207c813d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1999284333-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff7tDidpsIezjbEriksOY%2Fuploads%2FVHGBWmcW5PmILUEvTkUd%2FScreenshot_99.png?alt=media&amp;token=62fc8f8d-82f3-43ab-b6a2-8fd03e13cf52" alt=""><figcaption></figcaption></figure>

After this step, the Stripe Escrow system is ready for using on your site.

You can turn on the Payment test mode in admin dashboard for testing.

<figure><img src="https://1999284333-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff7tDidpsIezjbEriksOY%2Fuploads%2F53n1YS2ZWEkrHBkSNkhC%2FScreenshot_100.png?alt=media&amp;token=0339c324-779c-4e19-9cdf-cde935905ad8" alt=""><figcaption></figcaption></figure>
