Author Archive

How freelance marketplace works?

WorkScout not only offers classic job board and resume feature but also includes a freelance marketplace, enabling freelancers to earn by completing micro jobs or user-posted projects.

  1. Employers can add micro jobs on gig basis. Freelancers can submit bids with their price and timeframe.
  2. Freelancers can manage their ongoing bids and employers their micro jobs in dashboard.
  3. Once employer select freelancer he wants to hire both will get access to project page.
  4. Each micro job has a dedicated project page for discussions, attachments, and progress updates. They can split project payments into multiple smaller payments using the Milestones feature.

    For example, a freelancer completes 40% of a project, submits a milestone, waits for employer approval and payment, then continues with the next phase.Once both parties confirm a milestone, the employer sees a Pay Now button.Payments are processed via Stripe Split Payments, automatically distributing funds and admin commission. Alternatively, the admin can collect payments (using any WooCommerce gateway) and manually pay freelancers.

    Related article: Commissions and Wallet →
  5. When project is finished by setting milestone to 100% they can both give each other reviews.

Related Article

Commissions and Wallet

AI Assistant Guide

Ask clear and specific questions!

Agent usually understand the context but you should ask in detailed way, for example:

❌ package change
✅ How can I modify paid package settings?

❌ disable similar jobs
✅ How can I disable similar jobs sections on single listing page

❌ Deactivate Resume
✅ How to disable specific resume listing?
✅ How to disable resume feature?

❌ Jobs don’t work
✅ I added jobs but I can’t see them  on map

Can AI Agent help me with coding?

No. Agent do not have access to theme files and cannot assist with coding, as this is restricted by our system prompt. Responses are based on our training data and the general knowledge about WordPress of the GPT-4o mini model.

AI suggested non-existent option

This might happen when a question is not precise or not covered in training data. The AI predicts answers based on patterns, so it may suggest for example setting that doesn’t exist.

Can I talk with AI agent in any language?

You can chat with the AI in your language, but answers may be less precise since Listeo training data is in english.

Also, if your question is not precise or uses unusual terminology in your language (e.g. “Add an Add” instead “Add Job”), the AI might not fully understand it.

 

By starting a conversation with chatbot, you acknowledge that we may have access to your conversation with chatbot in order to help improve the chatbot and training data.

My currency is not on the list

If your currency is no on the list in WorkScout Core → General → Currency you can add custom currency using PHP snippet.

add_filter('woocommerce_currency_symbol', 'change_currency_symbol', 10, 2);
   function change_currency_symbol($currency_symbol, $currency) {
     if($currency === 'XOF') {
     return 'CFA';
   }
   return $currency_symbol;
}

How to add PHP snippets?

 

How to troubleshoot Stripe Split Payments

Setting up Stripe Connect in WorkScout can be a challenging process, and we frequently receive support tickets from users seeking assistance with troubleshooting. Here are a few steps you can take before reaching out to us.

Step 1

Go to Overview of your Stripe Connect dashboard,
Ensure that there are no tasks on the list tagged as “Required” and that all necessary steps are completed.

This is example of not fully configured account, the platform profile is not completed. That will cause troubles with Connect button on wallet page. The onboarding process won’t be correctly completed.

Step 2

Go to your WordPress admin -> WooCommerce → Settings → Payments → Stripe → Manage → Settings

Make sure the payment options are correctly configured and you have green checkmark  in all options

it’s especially important for Webhooks as that what we mainly use in Listeo to work with Stripe API. Make sure it works both in test mode and live mode.

While we’re here you enable log, that will help us debug any issues, it’s below in Advanced Settings.

Step 3

Double check if all keys are set correctly, and they match the settings in your Stripe Dashboard, both for Live and Test mode

Step 4

If you made sure everything above is set and it still doesn’t work, we need admin access to your site.

You can create temporary admin account and delete it later or you can install this plugin https://wordpress.org/plugins/temporary-login-without-password/ and generate for us the link for 1 week admin access (make you’re creating user with ADMIN ROLE as by default it will be regular user).

Please also make sure that:

  1. You’ve set your Stripe payment gateway in Test mode
  2. You have one user with Candidate (Freelancer) role who has at least 1 published listings, and is connected to your Stripe Platform in the Wallet page. We most likely won’t be able to do that as it usually requires some address/contact data
  3. Please install this plugin https://wordpress.org/plugins/wp-user-switch/ to allow us easy change between users for tests
  4. And if you haven’t already, please contact us via Support Tab

 

Stripe Split Payments Support

Before you’ll raise a support ticket:
1. Ensure that the API keys and permissions are correctly configured in both WP and Stripe.
2. Verify that the Redirect URI in Stripe matches the one in your WordPress plugin.
3. Confirm that your Stripe account is fully verified (not pending).
4. Make sure you are not using account that is already connected to other platform
5. Clear any cache that might interfere with the connection.
6. Check https://docs.purethemes.net/WorkScout/knowledge-base/how-to-troubleshoot-stripe-split-payments/


[Discalimer] WorkScout works with hundreds of payment gateways however split payment could be technically only Stripe. Without split payment you can use any payment gateway that works with WooCommerce but you will need to handle payouts manually. 🙂

WorkScout offers support for Stripe Connect that allows you to automatically split the payment for a micro jobs and send part of the payment to the freelancer and part (commission) to you as a site owner. Stripe Connect is a service provider for marketplace payment solutions.

This requires having the official WooCommerce Stripe Payment Gateway installed and configured, only the payments made by this gateway will be split.

With Stripe you can accept Visa, MasterCard, American Express, Discover, JCB, and Diners Club cards or even Bitcoin and is supported in 47 countries

With a Stripe Connect, you create a platform to which freelancers can signup and “connect” and that helps you automate payments and simplifies the usage of your site.

 

How it works

You have to enable your Connect Platform in Stripe dashboard. After properly configuring both Stripe and WordPress according to instructions below, the Wallet page will have an option “Connect to Stripe“.

Any Freelancer who will click this button will be going through the “onboarding” process where he will set his own Stripe account and connect it to your platform. From now on every booking that will be made using WorkScout that will be paid with Stripe gateway will be automatically splitted and you as platform freelancer will get the commission and the freelancer will get his earning directly to his Stripe account. The money is then payout automatically by Stripe based on the settings or rules (it’s different based on the country)

How to configure Stripe Connect in WorkScout

Let’s get started
  1. Create a stripe account by visiting https://stripe.com/. You’ll be viewing a page that asks you to Activate Payments, click that button to fill out your business profile to accept payments
  2. Go through the whole process of onboarding https://dashboard.stripe.com/account/onboarding – make sure you haven’t skipped any field there.

    It’s very important to have all the items checked, you even need to set your own branding color or upload logo as without it it won’t let you set Connect accounts.

  3. Next step, open Stripe Dashboard go to Connect, then go to “Get started with Connect“, where you will be able to complete your platform profile and add required informations to enable payments on your account

    Select “Buyers will purchase from you”

    Complete your platform profile and add required informations to enable payments on your account

    Select “Sellers will be paid out individually”

    In next steps select “Onboarding hosted by Stripe” and “Express Dashboard”
  4. Follow next steps to finish setting up Connect.

    It’s very important to have all the items checked, you even need to set your own branding color or upload logo as without it it won’t let you set Connect accounts.

  5. Get Client ID. For that go to Settings scroll down to Product Settings → Connect box,
  6. Navigate to Onboarding Options
  7. Copy your Test mode client ID and paste it in WorkScout Core → Stripe Connect → Stripe Connect Test Client ID.

    and turn on OAuth Settings
  8. in Redirects section click +Add URL, and add there a link to your wallet page with /?stripe-setup=yes at the end, so the whole link would be
    https://www.yourdomain.com/wallet/?stripe-setup=yes
  9. Now Switch to Live mode and repeat those steps, get the Live Client ID to set it in WorkScout Core, enable OAuth settings and add Redirect.
  10. In Stripe Dashboard →Developers you’ll find Publishable and Secret Key, copy them to WorkScout Core → Stripe Connect fields, there are inputs for both keys for test and live mode, and you need that to onboard users. If you can’t copy/reveal the Secret Key in Stripe Dashboard, you can create a new one using “Create secret key” button.
  11. Review all other options

Setting Up WooCommerce Payment Gateway

  1. Install WooCommerce Stripe Payment Gateway
  2. Go to WordPress Admin → WooCommerce → Settings → Payments, find Stripe on the list, go to Manage and connect to your Stripe account you’ve just created in step before.

    It’s VERY important to not create a new account from that link in plugin, it has to be the one you already have and already has Connect enabled.

  3. It should automatically get all required API keys, but to be sure go to Settings, click Edit Account Keys and make sure both test and live keys are set.
  4. Set the webhook in your Stripe Account Settings as it’s explained in the popup. It’s important as this webhook is what is used to get data about payment. Make sure the webhook type is set to Account, not Connect.
  5. It’s important to know that this feature in WorkScout is in its early stage and although we did a lot of testing we strongly encourage to run it in Test mode first to make sure everything works as expected. To do that go to wp-admin → WooCommerce → Settings → Payments → Stripe → Manage → Settings and check the “Enable test mode” checkbox

    After Connecting to Stripe, users will have a new box in Wallet page with few informations about his account and option to login directly to Stripe Dashboard to see all details about the payments to his account.
    Example view of Stripe Dashboard for freelancer

Before you’ll raise a support ticket:
1. Ensure that the API keys and permissions are correctly configured in both WP and Stripe.
2. Verify that the Redirect URI in Stripe matches the one in your WordPress plugin.
3. Confirm that your Stripe account is fully verified (not pending).
4. Make sure you are not using account that is already connected to other platform
5. Clear any cache that might interfere with the connection.
6. Check https://docs.purethemes.net/WorkScout/knowledge-base/how-to-troubleshoot-stripe-split-payments/

Commissions and Wallet

How payment system for micro jobs between employer and freelancer work in WorkScout?

Each order is tracked in WordPress Dashboard → Commissions, showing how much to transfer to the listing owner. As the admin, you receive payments from employers on behalf of freelancers unless you configure Stripe Split Payments.

Related article – Stripe Split Payments: https://docs.purethemes.net/WorkScout/knowledge-base/stripe-split-payments-support/

As an site administrator you can take fee from each micro job.
For an example: If an employer posts a micro job like “WordPress Theme Installation” for $100 and hires a freelancer, a commission e.g. 10% fee ($10) goes to you. The remaining $90 is paid to the freelancer upon completion of the job/service.

You can set commissions rate in Dashboard → WorkScout Core → Projects and Wallets 

Payouts can be managed in Dashboard → Commissions.

By clicking “Make Payout” button you will be redirected to the page with unpaid orders summary. After making payout orders you will be redirected to next page with payout summary/withdrawal details. All orders will be marked as “processed” in listing owner’s “Wallet” page and his “Withdrawable Balance” counter will be reset.

You browse payouts history and check details of each payout in Commissions → Payouts History

Payment method chosen by listing owner will be visible above commissions table. Money transfer has to be done manually by the site administrator.


Freelancers have an additional “Wallet” page in the dashboard where they can check summary of their earnings from micro jobs, payouts history and set payout method.
If you don’t see “Wallet” page make sure it’s created with [wallet] shortcode and assigned in WorkScout Core → Pages.

Custom Commission

You can individually modify commission for each user by editing user details in WordPress Admin → Users

Login & Register Form Fields Editor

WorkScout offers drag&drop field editor for login and registration page. In this article we’ll present how to add custom field to registration form.

Adding custom fields to registration form

Step 1

First you have to create custom field. Go to WorkScout Core → User Fields. There are two tabs for Candidate and Employer as you can set those fields separately for each role.

For this guide purpose we will add VAT Number field for employers.

Click the green button Add field, type a name and click OK, you will see box with new field and options for that field. You can switch Type of this field to dropdown, radio, checkbox or even file upload field. You can add icon aswell.

Fields you will create are automatically added to My profile page in dashboard.

Step 2

When you are ready click Save Changes and  go to WorkScout Core → Registration Fields. Here you will see the field you’ve just created in the Available Fields section in the right side, you can simply drag&drop it to the fields area, and save.

That way this field will be now added to your registration form. You can change the label or set a new icon for that field.

The field you created will also be visible in WordPress Admin → Users. For example, if you add a file upload field, you can download the file by going to Users, clicking “Edit” on the user you want to access, and finding the field with the attachment.