readwarn/jumga

A marketplace for buyers and sellers.

jumga

Jumga is marketplace created for buyer and sellers of product. A seller uses the platform to advertise and sell his/her products. The buyer browse through the marketplace to buy products. The payment system for the marketplace is facilatated with the flutterwave v3 api.

Preview

Jumga live link

Features

• Seller sign up with account detail
• Account detail is verified with the flutter api
• Seller cant upload product to marketplace until the store is approved by paying $20
• Seller can edit the quantity (amount they have in stock) of previusly uploaded product by clicking on the product card
• Payments are accepted through flutterwave standard v3 api
• To share payments accordingly between Jumga owners, seller and disapatch riders, subaccount was created for each.
• The app is in test-mode i.e you can only regsiter with test account and can only pay with test card

Test accounts

Use these test accounts

• Access Bank Account number: 0690000031 OTP: 12345
• Access Bank 2 Account number: 0690000032 OTP: 12345
• Access Bank 3 Account number: 0690000033 OTP: 12345
• Access Bank 4 Account number: 0690000034 OTP: 12345

Test cards

Use these test cards

Test MasterCard PIN authentication

• Card number: 5531 8866 5214 2950 cvv: 564 Expiry: 09/32 Pin: 3310 OTP: 12345

Test Visa Card 3D-Secure authentication (VBVSECURECODE)

• Card number: 4187 4274 1556 4246 cvv: 828 Expiry: 09/32 Pin: 3310 OTP: 12345

Test Card Insufficient Funds

• Card number: 5258 5859 2266 6506 cvv: 883 Expiry: 09/31 Pin: 3310 OTP: 12345

Project setup

To run the app locally on your computer you will need to create a mongodb connection url and also a flutterwave account. After signing up with flutterwave, navigate to your dashboard, toggle to test-mode, then click on settings then API, here you can see your account API keys, copy the secret key as shown below.

Flutterwave secret keys

Mongobd connection url

With the mongodb connection url and the flutterwave secret-keys ready, you can now clone this repo on your computer then take the following steps.

• cd into Jumga directory/folder i.e type in 'cd jumga' in the command terminal
• cd into the server directory
• create a .env file. You can use this command [touch .env]
• copy and paste your mongodb connection url and your flutterwave secret api keys
• Your .env in the server directory file should look like this.
• run 'npm install'
• run 'npm start'
• cd into the client directory and run 'npm install' then run 'npm run serve'
• goto http://localhost:8080/.