CasperVend 2/Gift Cards

From CasperTech Wiki
Jump to navigation Jump to search

The Gift Card expansion pack for CasperVend allows you to give (or sell) gift certificates for use in your store. They work just like a store card in real life - you can sell them or give them out however you wish, and the recipients can use them to buy things at your store.

**** VERY IMPORTANT ****

IT IS YOUR RESPONSIBILITY TO ENSURE THE PERMISSIONS ON THE CARDS ARE SET CORRECTLY BEFORE HANDING THEM OUT. YOU MUST SET "NO COPY" PERMISSIONS ON THE SCRIPT INSIDE THE CARD AS WELL AS THE PRIM. If you hand out a "copy" gift card, it could give that person unlimited access to your store products! We have safeguards in place to help prevent this, but at the end of the day, we accept no responsibility for damage caused by gift cards being handed out as copy.

As of version 1.46, we have implemented a new security process which will disable your gift card if it's given out with the wrong permissions. This is for your protection - but don't rely on it. Check your permissions anyway.

If you need any help with setting the permissions correctly, please contact Casper Warden.

Compatibility

This gift card [version 1.46 / 1.5 / and up] plugin ONLY works with:
  * CasperVend Core System v1.44 and upwards
  * CasperVend Holovendor v1.46 and upwards
  * CasperVend Affiliate Plug-in v1.44 and upwards
  * CasperVend TextureVend v1.43 and upwards
  * CasperVend SuperMesh v1.43 and upwards
  
Gift card versions 1.45 or older will NOT work with newer vendors!
Older vendors will NOT work with 1.46 or newer gift cards!
Other CasperTech products - CasperLet, etc. - do NOT work with gift cards!

Setup by merchant

Step 1 - Rez the gift card on the ground
This is important because renaming and permission changes have to be done inworld (on the ground) in order for them to stick when the item gets sold or passed on to the next user.
Step 2 - Optional
If you have a texture to brand it for your shop, apply it to the front of the main prim at this time. Make sure YOU have at least copy/transfer permissions on the texture you are using.
Step 3 - Rename the Gift Card
(A) Right-click, then "Edit"
(B) On the "General" tab, click to put the cursor in the "name" box
(C) Give it a new name (something like "[Your Shop] Gift Card")
(D) STAY IN EDIT MODE
Step 4 - Setting the Internal Script Permissions
(A) Go to "contents" tab
(B) Right-click on the script, select "Properties". A separate properties window will pop up.
(C) On the bottom of the properties window, under the "next owner" section, UNcheck the box for "copy.
(D) Wait about 10 seconds for SL to update that status
(E) Close the properties window, then the edit window.
The script is no-mod, and will not open. This is normal. You are working with the "next owner" properties, which does not require opening the script. The permissions absolutely need to be set this way ON THE SCRIPT, otherwise you risk customers finding a way to copy the gift card, and reuse it multiple times!
Step 5 - Set Balance
Issue the "set balance [x]" command, where "[x]" is the amount of LINDENS. No commas, quotes or dollar signs are necessary. (Alternately, you can set it to a specific product - see below.)
Step 6 - Gift Card Hover Text
By default, the hover text shows either "Please click on a CasperVend Vendor to use" or "Please click on a CasperVend Vendor to get the option to use your remaining balance of ___". If you want to change the "CasperVend Vendor" portion in that hovertext to something else, use this command:
set text [your store vendor]
where "[your store vendor]" is the replacement text of your choosing.

Set to a product

If you prefer, you can set your gift card to dispense a specific product, rather than giving the customer a balance. This means they won't have to visit your store to get the product delivered.

You CANNOT use the "set product" feature with texture vendors. This is because they dont' use networked delivery.
Step 1
Rez the gift card on the ground. (As long as it's a gift card for YOUR store, this automatically puts it in merchant mode.)
Step 2
Type "set product"
If you change your mind before selecting the product, just type "cancel" to go back to merchant mode.
Step 3
Click a product on one of your vendors, and the product image will appear on the card.
Step 4
As soon as you select the product, the gift card will automatically go back to merchant mode.
If you've ALREADY set a product onto your card and want to cancel it, just click "Buy Now" and ignore/discard the delivery.
To change the product again, type "set product" again.
Step 5
The card is all set, and you may now pick it up again.

When the product is delivered, the card will be "depleted" and will default back to balance mode. Defaulting back to balance mode SHOULD leave the card with a L$0 balance. If you have a top-up terminal, the user can top up the card for future use.

Test mode

Step 1
Complete the card setup first.
Step 2
Issue the command: set test
The gift card hover text will change to show what the customer will see. The gift card is now in test mode.
Step 3
If you have one of your vendors nearby, click it, and the gift card image will change to show a picture of the vendor's item, with a "buy" button.
Step 4
Click "buy now"

Exit test mode

If you have the card rezzed on the ground
Right-click, then "take" the card
If you are wearing the card
Right-click, then "detach" the card
If you want to issue an exit command
type: exit test

Additional Notes

Pick up the card when you're all done and it's ready to go - it does NOT matter what mode the card was last in when you hand it out; anyone who is not you does NOT see the merchant mode when they rezz or wear the card.

Do NOT copy/paste the card within your inventory, or the new copy in inventory will default to a balance of L$0.

Optionally, you can rez the CasperVend Gift Card Topup Terminal to allow your customers to "refill" their gift card. Topups will appear on your CasperVend sales history like any other sale.

Troubleshooting / FAQ

Q. Is it possible to configure gift cards to give a certain discount on a certain product?
A. No. But you can configure a gift card to give a product, then sell the gift card for the discounted price.
Q. Can you use the gift card to send a gift to another person?
A1. No, gift cards cannot be used to send gifts. Gift cards are intended to BE gifted, so that the giftEE can use them.
Q. My gift cards won't communicate with the vendors! Help!
A. You have a version mismatch issue. Gift card versions 1.46 and newer will NOT work with vendor versions 1.45 or older. Gift cards from version 1.45 and older will NOT work with vendor versions 1.46 and newer.