CasperVend 2/Redeliveries: Difference between revisions

Latest revision as of 20:02, 18 April 2018

About the Redelivery System

The redelivery system has the unique feature of allowing global redelivery.

What this means is that any customer may use ANY merchant redelivery terminal (or the "redeliver" popup menu option via the vendor) to redeliver a copiable product from ANY other merchant.

Where's the Redelivery Terminal?

For convenience, there is a redelivery terminal included in both free and premium vendor crates. (In the fatpack crate, this will be in the "premium vendor" box within the fatpack crate.)

The redelivery terminal is both copy and transfer, so if you have affiliate/franchise packs, you can tuck a redelivery terminal in there.

Customising the Redelivery Terminal

Rez the CasperTech Redelivery Terminal on the ground.
Right-click > Edit > Contents > Pull the script from the terminal to your inventory.
Rez your desired redelivery object on the ground.
Right-click > Edit > Contents > Drag the redelivery script from your inventory into your desired object.

That's it! No additional script or website configuration is necessary!

Who Can Redeliver Products?

The person who received the product is the one who is able to claim redelivery, if it is marked copy on the website.

If a customer was gifted a copiable item, but for SL reasons it never arrived, that customer may claim redelivery without having to track down the person who sent it to them.

Setting Redelivery Options

One of the things the website asks for when you enter your product details is "product permissions". These settings do two things:

It gives information to the customer via the "Info" option so they know what to expect.
Controls whether the customer can collect a redelivery.

The website is unable to change permissions on any items in your dropbox, so it is essential that you set your permissions properly on both your products inworld as well as on the website.

All Purchases

All purchases will be shown on the redelivery page.

This does not mean that all products that are visible will be redeliverable.

The images below will illustrate the difference in the redelivery page listings between products marked copy and no-copy.

Product set COPY	Product set NO COPY

Allow Redelivery of Copiable Products

Log in to [CasperVend]
Click Products tab
Create your product as usual
On the permissions line, make sure "Copy" is ticked/checked
Click save

Prevent Redelivery of No-Copy Products

Log in to [CasperVend]
Click Products tab
Create your product as usual
On the permissions line, make sure "Copy" is NOT ticked/checked
Click save

Redelivery HUD and API Options

Since version 2.4 of the terminal, it's possible to customise the generation of redelivery URLs.

To customise the redelivery terminal, there are two options:

1. With the regular terminal (v2.4 or up), you can add a merchant UUID to the description in order to get it to generate a redelivery page for that MERCHANT. The format is:

MERCHANT:<user key>

for example

MERCHANT:d1cd5b71-6209-4595-9bf0-771bf689ce00

for the CasperTech store.

2. SCRIPTERS ONLY: Use the extra script added to the vendor packs as of 2017-11-12. The script is called "8) Redelivery Link Generator v2.4 for HUDs", and you can send a linked message to it as follows:

key user = "put the user's UUID here";
key merchant = "put the merchant's UUID here";
llMessageLinked( LINK_THIS, 0, "REDELIVER|"+(string)merchant, user );

Note that for security reasons, the URL is sent directly to the user. It's not possible to intercept the URL. The user must be on the same region as the script.

If you don't yet have v2.4, you need to get the latest version!

FAQ / Troubleshooting

Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.

A1. Reset the dropboxes via the touch/popup menu. If that doesn't work, then manually Edit > "Reset scripts in selection".

A2. If you only have dropbox(es) on ONE sim/region, then we strongly recommend having a duplicate set on at least one other sim/region.

@@ Line 2: / Line 2: @@
    |__TOC__
    |}
+<!-- redelivery -->
 [[File:German_flag.gif]] [[CasperVend 2/Redeliveries/DE | Schaue hier in Deutsch!]]
@@ Line 18: / Line 19: @@
 === Customising the Redelivery Terminal ===
 ----
-Simply remove the redelivery script from an official redelivery terminal, and drop it in your custom redelivery object.
+:# Rez the CasperTech Redelivery Terminal on the ground.
+:# Right-click > Edit > Contents > Pull the script from the terminal to your inventory.
+:# Rez your desired redelivery object on the ground.
+:# Right-click > Edit > Contents > Drag the redelivery script from your inventory into your desired object.
-No additional script or website configuration is necessary!
+That's it! No additional script or website configuration is necessary!
 == '''<span style="color:#00528c">Who Can Redeliver Products? </span>''' ==
@@ Line 35: / Line 39: @@
 The website is unable to change permissions on any items in your dropbox, so it is essential that you set your permissions properly on both your products inworld '''as well as''' on the website.
-=== All purchases ===
+=== All Purchases ===
 ----
 All purchases will be shown on the redelivery page.
@@ Line 41: / Line 45: @@
 This does '''not''' mean that all products that are visible will be redeliverable.
-The images below will illustrate the difference in the redelivery page listings between products marked copiable and no-copy.
+The images below will illustrate the difference in the redelivery page listings between products marked copy and no-copy.
 {| class="wikitable"
@@ Line 71: / Line 75: @@
 [[File:Redelivery--WebsiteNoCopy.png|450px]]
+== '''<span style="color:#00528c">Redelivery HUD and API Options </span>''' ==
+Since version 2.4 of the terminal, it's possible to customise the generation of redelivery URLs.
+To customise the redelivery terminal, there are two options:
+: 1. With the regular terminal (v2.4 or up), you can add a merchant UUID to the description in order to get it to generate a redelivery page for that MERCHANT. The format is:
+:: MERCHANT:<user key>
+:: for example
+:: MERCHANT:d1cd5b71-6209-4595-9bf0-771bf689ce00
+:: for the CasperTech store.
+: 2. '''SCRIPTERS ONLY:''' Use the extra script added to the vendor packs as of 2017-11-12. The script is called "8) Redelivery Link Generator v2.4 for HUDs", and you can send a linked message to it as follows:
+:: <syntaxhighlight lang="lsl">key user = "put the user's UUID here";
+key merchant = "put the merchant's UUID here";
+llMessageLinked( LINK_THIS, 0, "REDELIVER|"+(string)merchant, user );</syntaxhighlight>
+: Note that for security reasons, the URL is sent directly to the user. It's not possible to intercept the URL. The user must be on the same region as the script.
+If you don't yet have v2.4, you need to '''[[Updating#How_to_Get_the_Latest_Version | get the latest version!]]'''
 == '''<span style="color:#00528c">FAQ / Troubleshooting </span>''' ==
 :'''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''
 :: '''A1.''' Reset the dropboxes via the touch/popup menu. If that doesn't work, then manually Edit > "Reset scripts in selection".
-:: '''A2.''' If you only have dropbox(es) on ONE sim/region, then we strongly recommend having a [[CasperVend_2/DropBoxes#When_Possible.2C_Have_Duplicate_DropBox.28es.29 | duplicate set]] on at least one other sim/region.
+:: '''A2.''' If you only have dropbox(es) on ONE sim/region, then we strongly recommend having a '''[[CasperVend_2/DropBoxes#When_Possible.2C_Have_Duplicate_DropBox.28es.29 | duplicate set]]''' on at least one other sim/region.