Handyman Service - Documentation
Handyman Services

General FAQs

Estimated reading: 2 minutes

1. Symlink() has been disabled for security reasons?

When you get an error while running php artisan storage:link,please follow the below steps :
Second way, just fire this command
ln -s /home/your_application/storage/app/public /home/your_application/public/storage

2. Migrate Database Issue?

If you are facing a problem migrating database using command the please follow the below steps.
Go to the main dir handyman-service-service
then find handyman-service_service.sql file and import to the database.

3. Forgot password Swift_Transport Exception?

If you are facing any swift transport type issue while sending mail,
then, please set the mail config in your .env file
please follow the below step.
MAIL_DRIVER=your mail driver
MAIL_HOST=your mail host
MAIL_PORT=your mail port
MAIL_USERNAME=your mail id
MAIL_PASSWORD=your mail password
MAIL_ENCRYPTION=your mail encryption

4. How to add a new language into Flutter app?

Follow this document – How To add new App Language

5. What is a Job Service List?

Users can add post job services from the Customer app, which is displayed as “Job Service List” in the Admin Panel sidebar menu.
Additional Details provided here – Job Service List

6. What is a Package List?

Providers can add service packages by selecting single or multiple categories. These will be displayed as Package list a sub menu of sidebar “Service” menu in the Admin panel.Providers can also add it from the Provider App. These Package Services will be available in Service List in the Customer App.
Additional Details provided here – Package List

7. How do payouts work for the Provider? What is the Provider payout list tab in Provider Detail in the Admin panel?

The commission amount earned by the Provider from the Admin is transferred to the Provider’s bank account by clicking the Payout Button.
Additional Details provided here – Provider Payouts

8. What is a Bank List & how does that work?

This bank list will be used at the time of making payouts for the Provider. Whichever bank the Provider has earned from, the Admin can add that bank from the list to the particular Provider and add their bank details. Then, the Admin can transfer the earnings to the Provider in that particular bank.
Additional Details provided here – Bank List

9.What is an Unassigned Handyman and Handyman Request List?

Unassigned Handymen are those handymen who are not assigned to any Provider.
Handyman Request List When Handyman register themselves from App or Website first they’ll require Admin approval for their account activation. So those Handyman who have registered will be displayed for Account Activation Approval
Additional Details provided here – Unassigned Handyman

10. Explain the commission split between the Admin, service Provider & the Handyman

First, the Admin sets the commission rate. Then, the Admin assigns a portion of the commission to the service Provider based on their Provider type. Subsequently, the Provider decides on the commission percentage for the Handyman, depending on the type of Handyman.
Additional Details provided here – Commission Split

11. How does the tax work for the Admin & the Provider or Handyman? How to apply the tax?

There is no connection between the ‘Handyman and Provider’ with ‘tax’. The Admin levies taxes in their own way, and when the user pays at the time of booking the service, the payment is made directly, reflecting only the Admin’s amount.
Tax can be set from Admin Panel. There will be Tax tab under the System menu inside sidebar
Additional Details provided here – Tax Configuration

12. In the payment list, it says pending by Admin, what does it mean? And How can it be resolved?

If you have opted for cash on delivery, the customer will initially make the payment to the Handyman. The Handyman will then transfer it to the Provider from their profile. (Handymen can view these earnings in today’s earnings if the user chooses cash on delivery today, otherwise, they can view them by clicking on monthly earnings.) The Provider will subsequently transfer it to the Admin from their profile. Afterward, the Admin needs to accept it from the Admin panel for it to reflect in the earnings of the Handyman.
If the cash payment is Pending approval from the Admin side in the final phase described above, it will display as ‘Pending By Admin’. The Admin can then approve it, and it will subsequently reflect on the Handyman’s and Provider’s Dashboards.
Additional Details provided here – Pending Admin

13. How to add an amount in the wallet for a user specifically or how to add cash in the wallet in bulk & how to use the wallet?

– Enable the user wallet button from the admin panel’s Setting ➜ App Configuration tab.
– The user gets the wallet balance option in their profile page.
– If a user wants to top-up their balance, they can easily do so with a click on the wallet balance option.
– If a user wants to top-up their balance from the admin side, they need to manually contact the Admin and make a cash payment directly to the admin. The Admin can also top up from the Admin panel.
Additional Details provided here – User Wallet

14. Where is the wallet option for customers in the app?

Customer can see their Wallet details from their Profile
Additional Details provided here – User Wallet

15. Can you create a coupon for a certain value?

To create a coupon :
– Open admin panel
Transactions ➜ Coupon ➜ Add Coupon
– Fill the form
Choose the discount type (percentage or fixed).
Select the services where the coupon will be applicable.
Specify the coupon value or percentage.
– Submit the form to create the coupon.
* Additional Details provided here – Coupon Creation

16. What is a plan list & how it will impact the Providers earnings?

Admin panel offers two options –
Commission and Subscription
Subscription: If Subscription is selected, providers need to purchase a subscription from the app.
After purchasing a subscription, the admin won’t charge for services provided to the provider and the handyman. Only the provider & handyman manage these service charges on their side.
Commission: If Commission is selected than Admin will receive decided part of earning from bookings
Additional Details provided here – Plan List & Provider Earnings

17. Provider is submits documents, similarly where will handymen submit documents?

The document verification feature is provided only for Providers.
Handymen Document verification is done manually We have only provided the document verification feature for Providers. We have designed the flow of this product so that verification of handymen is done manually

18. Facing issue with upload image limit?

To resolve this issue, you can adjust the following PHP configuration settings:
post_max_size: This setting determines the maximum size of POST data that PHP will accept. Since file uploads are also considered as POST requests, increasing this value ensures that PHP can handle larger file uploads. In this case, it’s set to 16M, meaning a maximum of 16 megabytes.
upload_max_filesize: This setting specifically controls the maximum size of individual file uploads. By increasing this value to match the post_max_size, you ensure that PHP allows file uploads of the same size. Similarly, it’s set to 16M to allow uploads of up to 16 megabytes.
By increasing these values, your system can handle image uploads of up to 16 MB, providing users with a smoother experience and resolving the reported error.

19. How to Add a service FAQ?

How to Add a service FAQ?
-Navigate to the Admin Panel.
– Under the Service section, select the Service List Option.
– Locate the “Add (+)” button in the Action Column and click on it.
– Then, click on the “Add Service FAQ” button and proceed to add a new service FAQ.
– Then, click on the “Add Service FAQ” button and proceed to add a new service FAQ.
Check this out for more detailed information – Plan List & Provider Earnings

20. How to update colors for application and web/admin panel?

Check this doc for update colors for application and web/admin panel – Update Colors

21. How In App Purchase works with subscriptions system?

After all the correct configurations inside admin panel provider can purchase subscription of the platform through Appstore or Playstore.
What is correct flow for In App Purchase configuration for subscription system?
1. Setup Google Play Console Subscription
2. Setup App Store Subscription
3. Setup RevenueCat
Keep note that you have to add same identifiers from RevenueCat to admin panel plans.