Contents

Overview

The Faeline Merchant Vendors system is a web managed, central distribution system, low lag and low land impact system for you to sell your products in Second Life. It can also new used to deliver free items, information notecards and demonstration versions of your products.

Web Managed

Set up products (e.g. product image textures and prices), in-world vendors (e.g. which products are sold where) and inventory (e.g. central distribution points in-world for the products you sell) are all managed on the web site.

Central Delivery

You put your products in one or more distributor mushrooms not the vendors, so there is a single location to add new products or change or update existing ones.

Affiliate Option

Allow others, your affiliates, to sell your products for a percentage of the sale price.

Easy to Use

The vendors are easy to use in-world for your customers with minimal touches to select the product and buy it. The web site is very easy to use to manage your product range and where each item is sold and distributed from.

Very Low Land Impact

Low land impact is important because the lower land impact for your vendors the more you can use for your rented locations.
All Faeline Merchant products, both mesh and prim variations, are designed for low land impact, for example distributor mushrooms, single product vendors, notice boards and demo boxes are 1, 3 product vendors are 2, 4 and 4 product vendors are 3 etc.

Sales & Transaction Reporting

A full history of all transactions by customer, region, vendor and date is available for online reporting or downloading as a CSV file.

Sale & Delivery Notifications

You can be notified of sales and deliveries by email or in-world instant message (IM).

Automatic Updates

New features and changes can be quickly and easily set up using an automatic script updater.

Secure and Reliable

The web application and in-world scripts are built be highly secure. The product delivery mechanism is highly resilient with multiple retry and alternative routing mechanisms in the event of communication problems. If all re-routing fails your customer will be given a refund in full.

Getting Started

1) Rez the your distributor mushroom

The first time you rez a distributor mushroom your web account will be created and you will be shows the web login details, for example:

Distributor Mushroom: Your web management account has been created
Login at: http://vendors.faeline.net
User name: Kitten Inventor
Password: Kit8a7eF
You can change your password after logging in

2) Log onto the web site

Log onto the Faeline Merchant vendor web site at http://vendors.faeline.net using your user Second Life user name and the password the mushroom gave you. You should see your new "Distributor Mushroom" on the mushrooms list.

You can (and should) change your web password from the "Change Password" link on the web home page; do not use your Second Life password or share your password with anyone else.

If you forget your password you can reset it by touching any of your mushrooms in-world and selecting "Reset Web PW" from the menu.

3) Add products to the mushroom

Edit your distributor mushroom in-world and go to the "Content" tab of the dialog. Drag the products (objects or notecards) you want to distribute from your Inventory to the Content of your distributor mushroom, e.g. Blue Box, Green Box and Yellow Box below.

You can ignore the 2 scripts in the distributor mushroom, but they must not be removed.

Close the edit dialog and touch the mushroom, this will show you a menu:

Select "Web Update" and the hovering text above the mushroom should show the number of products and notecards and that the distributor mushroom is active.

The products you added to the mushroom will now be listed on the web site each with an "Inactive" status which means they are not yet ready to see or distribute.

Only objects or notecards which you have Copy and Transfer permissions for can be distributed, and others you add to the mushroom will be ignored. Your customers receive whatever permissions you set for the next owner.

4) Set up the products on the web

For each product that you added to the distributor locate it in the web site and update the name, price and texture UUID.

For the picture you want to use for the product poster, locate the texture in your inventory and copy the UUID, e.g. "Copy Asset UUID", before pasting it into the "Texture UUID" in the product form on the web site.

When the product is set up check the "Active" checkbox and click "Update".

5) Rez a vendor

Select the vendor style you need, rez it, resize and position where you want it in your shop. Initially you will be asked for debit permission, you need to "Allow access" for the vendor to work. Debit permissions are used to refund money to your customer in the event of a failed delivery, and are used to pay commission to FaelineAgent for the free vendors.

It will initially appear "Offline".

6) Set up the Vendor and Template on the web site

Locate the vendor in the web and either select a template from the dropdown list, or if you have not created any templates yet select "New" to define a new template.

Set up the template with the products, demo, banner etc. you want.

The return to the vendor and set the status to "Active".

The vendor in-world should now be fully functioning.

Affiliate Vendors Only

7) Give the Vendor to the Affiliate

Take the set up vendor into your inventory; making sure it is either Offline or Active first. Then give it to the affiliate and ask them to rez it.

8) Setup the Affiliate Percentage

After the affiliate has rezzed the first of your vendors locate their name in the affiliates list and set the percentage and notifications option.

The default percentage is 0% which means you will receive everything after commission and they receive nothing.

The affiliate vendor in-world should be fully functioning and the affiliate can sell your products.

Distributor Mushrooms

Distributor mushrooms are the in-world object where you place your products for delivery.

A distributor mushroom may have one of the following statuses:
ActiveThe mushroom can deliver products.
InactiveSet as offline from the in-world mushroom; inactive mushrooms will not deliver products.
RegisteredThe mushroom is rezzed in-world but it does not contain any products.
UnresponsiveThe in-world distributor mushroom is not communicating properly with the web site and it may have been deleted.

For reliable distribution you should use a number of distributor mushrooms in different regions and ensure that each product you sell or give away is in more than one mushroom.

After adding or changing the products in your distributor mushroom you will need to touch it in-world for a menu then select "Web Update".

From the menu you can switch on or off the information hover text above the mushroom, reset your web password, set the mushroom offline so it will not deliver any products it contains or go to the web site.

Distributor mushrooms may be removed from the list if the in-world mushroom is deleted and at least 25 minutes have passed (and the mushroom is listed as "Unresponsive").

In-world you can change the name or the distributor mushroom and even the size and appearance if you want. The active important parts are in the scripts.

You can put any number of objects and notecards in a Distributor Mushroom but it is probably worth keeping it under 100 as the object in-world object Content can get a bit slow to update when it has too many items.

Products

Products can be edited from the Products, Mushrooms or Templates lists on the web site.

A product has the following properties:
GroupThe product group lets you group together related products in the list and could be used for product lines or business groups.
NameThe name used to identify the product on this web site. This may be different to the object name in the distribution mushroom.
PriceThe price in L$ that your customers pay, use 0 for free items.
Texture UUIDThe texture UUID for the product picture. This must be exactly 36 characters and you can use the 'Copy Asset UUID' in your viewer.
StatusIf 'Active' is unchecked the product cannot be selected for a vendor template.

Products which are no longer in any distributor mushrooms and not linked to any templates will be automatically removed from the listing.

Templates

Templates are managed on this web site and define the products, look and behaviour of the in-world vendors. Each template can be used for different vendors in different regions to define the set of products the vendor sells.

A template has the following properties:
TemplateThe name used to identify the template in the web site.
ProductsThe products to sell or free items to deliver.
DemoThe free item for the "Demo" panel at the top right.
NotecardThe notecard for the "Info" panel at the top left.
Hover TextText that will hover over the vendor in-world.
Reset/IntervalThe main product panel can automatically change after a period of inactivity.
BannerThe banner texture is used at the top of the vendor.
ButtonsThe buttons texture will be used for notecard and/or demo buttons at the top of the vendor.
NavigatorThe navigator texture is used on multi-product vendors to select products not shown.

Templates can be deleted if they are not linked to any vendors.

You can create a new template from the "New" button on a Vendor form or from the "New" button below the Vendor Type diagram which can be seen when clicking on the "Type" row on the Template or Vendors list.

Vendors

Vendors or notice boards exist in-world and are configured by a template. There are many different vendor types in the Faeline Merchant product range, each with different designs or behaviour.

A vendor has the following properties:
NameThe name of the in-world vendor for single product vendors or noticeboards.
Name prefixThe name of the in-world vendor for multi product vendors will prefix the product name with this.
TemplateThe template they defines the products and behaviour of the vendor.
DescriptionThe vendor object description in-world.

A vendor may have one of the following statuses:
ActiveActive vendors are ready in-world to sell your products.
InactiveSet as offline from the web site; inactive vendors cannot sell any products.
RegisteredThe vendor is rezzed in-world but it does not yet have a template associated with it.
UnresponsiveThe in-world vendor is not communicating properly with the web site and it may have been deleted.

Vendors may be removed from the list if the in-world vendor is deleted and at least 25 minutes have passed (and the vendor is listed as "Unresponsive").

Vendor Debit Permissions

When a vendor is rezzed in-world for the first time you will be asked for permission to debit your account with a message like this:

The vendors system will not work without debit permissions and to use the system you will need to trust Faeline Merchant. This is the same for most vendor systems in Second Life.

L$ are debited from your account under the following circumstances only:
1)If your customer pays you for a product which is not possible to deliver they will be refunded the amount they paid in full.
2)If you use the free vendors commission will be charged (but not for full no-commission products, or for the noticeboard or demo delivery products). 5% of the purchase price (rounded up to the nearest L$1) will be paid to FaelineAgent after successful delivery of the item.

Faeline have been conducting business in Second Life since 2009 under the brands Faeline Kitty, Faeline Fairy and Faeline Merchant and we have thousands of happy customers.

Affiliates

Affiliate vendors are ones you give to someone else to sell your products for a percentage of the sale price. You control the products selection, pricing and the amount that the affiliate gets.

An affiliate has the following properties:
PercentageThe percentage of the sale amount that the affiliate retains from 0% to 95% (5% commission goes to FaelineAgent).
NotificationsIf checked the affiliate will receive IM notifications for each sale.

You will need to set up the percentage for each affiliate separately.

Before a new affiliate rezzes their first vendor you can still set them up as an affiliate on the Affiliates list using the "New" button. You will need to enter their name and key which can be found on their in-world profile. If set up in advance the vendor will be fully active as soon as it is first rezzed.

An affiliate vendor has copy, modify and transfer permissions so it can be rezzed at multiple locations. The affiliate will always receive the same percentage of each sale.

The affiliate can give the vendor to someone else to sell your products, however if you do the next affiliate will not automatically receive the same percentage as the one you originally granted. By default they will receive nothing and you get 95% after commission.

Vendor Debit Permissions

When an affiliate vendor is rezzed in-world by the affiliate for the first time they will be asked for permission to debit their account.

The vendors system will not work without debit permissions so they need to be granted.

L$ are debited from the affiliates account under the following circumstances only:
1)If the customer pays for a product which is not possible to deliver they will be refunded the amount they paid in full.
2)Commission of 5% of the purchase price (rounded up to the nearest L$1) will be paid to FaelineAgent after successful delivery of the item.
3)A royalty is paid to you by the affiliate who retains the percentage of the sale price set by you.

Account Settings

The following settings apply to the whole Faeline Merchant vendor system:
Business NameThe business name is used in the subject of notification emails and as the default product group.
Email AddressThe email address to receive email notifications.
Sale NotificationEmail confirmations sent upon delivery of a product that your customer pays for.
Free Item NotificationEmail confirmations sent upon delivery of a product such as a notecard or free demo.
Transaction NotificationInstant messages (IM) for each product delivery or money transfer such as a customer payment, refund or commission payment.
Default BannerThe default banner can be applied to all vendors when "Default" is selected on the template. Select from standard banners or "Custom" to use your own texture UUID which must be exactly 36 characters (you can use the 'Copy Asset UUID' in your viewer).
Default Buttons The default buttons texture will be used for notecard and/or demo buttons on all vendors when "Default" is selected on the template. Select from standard buttons or "Custom" to use your own texture UUID which must be exactly 36 characters (you can use the 'Copy Asset UUID' in your viewer).
Default Navigator The navigator texture is used on multi-product vendors to select the products not shown. The default navigator texture will be used on all vendors when "Default" is selected on the template. Select from standard navigators or "Custom" to use your own texture UUID which must be exactly 36 characters (you can use the 'Copy Asset UUID' in your viewer).

Vendor Types

There are many different variations of vendors, noticeboard and product delivery objects available in the Faeline Merchant product range. Each is managed from the web site and uses central distribution technology.

Commission

Commission is paid for free vendors and affiliate vendors at 5% of the purchase price rounded up to the nearest L$.

Free item delivered from free vendors will still pay commission at L$1 each delivery.

PriceCommissionNet Amount
L$0L$1-L$1
L$1L$1L$0
L$4L$1L$3
L$5L$1L$4
L$6L$2L$4
L$100L$5L$95
L$1000L$50L$950

You will not be charged commission if you buy from your own vendors to test them, or when an affiliate buys from their affiliate vendor.

Commission is not charged for delivery of the demo or notecard vendor buttons.

Commission is paid to FaelineAgent.

Updating Scripts

Vendors need to be active or offline before scripts can be updated, not in an "Inactive" state after first rezzing.

Rez your "Faeline Merchant Script Updater" coloured ball in the same region as your vendors or distributor mushrooms then touch it. Be sure it is rezzed in the correct land group or it might get ejected.

The updater will locate all your Faeline Merchant products in the same region and will visit each in turn to update the scripts.

You will need to grant each vendor debit permissions again after the script update, but otherwise every vendor or mushroom should automatically come back online.

Once complete the ball will move to you and turn grey; it can then be deleted. You should see the new script version numbers on the web site.

Troubleshooting

My vendor is offline

  1. Check the "Status" has the "Active" checkbox set on the Vendors list on the web site and "Update".
  2. See if the Vendor on the web site has a Template selected and select or create one if not.
  3. Try "Update" on the Vendors list even if it appears to be active.
  4. Touch the in-world vendor to attempt to get online.
  5. Take it into your inventory and rez it again, then set the correct Template again on the web site.

My products are showing as "Coming Soon"

  1. Check if the template has all the products listed that you need to sell.
  2. If the product is listed on the template check that it is in at least one distributor mushroom.
  3. Try "Update" on the vendor even if it appears to be active and the products look correct.

I've forgotten my web password

  1. Touch one of your distributor mushrooms in-world and select the "Reset PW" menu option.

Support

If you need any help using the system or have any suggestions please contact:
Pryda Parx (Faeline Merchant)