ANS - SL Marketplace Integration

Connect your SL Marketplace listings to AvatarShot using the Automatic Notification System (ANS). Every sale on the SL Marketplace will automatically sync to your AvatarShot store.

What is ANS?

ANS (Automatic Notification System) is a feature of the Second Life Marketplace. When someone buys your product, Linden Lab sends a notification to a URL you specify. AvatarShot receives this notification and:

Records the sale in your dashboard
Updates your sales stats and revenue
Queues delivery via your Delivery Bot (for redelivery)
Links the sale to the correct product

Setup Instructions

Step 1: Get Your Credentials

Go to My Store
Click the "SL Marketplace" tab
Copy your Notification URL and Notification Salt

Step 2: Configure on SL Marketplace

Go to marketplace.secondlife.com/merchants
Click on your store → Store Settings
Find the "Automatic Notifications (ANS)" section
Paste your Notification URL in the URL field
Paste your Notification Salt in the Salt field
Click Save

Step 3: Match Products

For sales to be linked to the correct product, make sure:

Product names on SL Marketplace match names on AvatarShot, OR
You set the SL Listing ID on each product (found in the SL Marketplace URL: /p/Product-Name/12345)

How It Works

Customer buys on SL Marketplace
        ↓
Linden Lab sends POST to your Notification URL
        ↓
AvatarShot receives: buyer name, item name, amount, transaction ID
        ↓
Sale recorded → Stats updated → Delivery queued
        ↓
Your Delivery Bot sends the item (for redelivery)

Data We Receive

Field	Description
TransactionID	Unique transaction identifier
BuyerName	Avatar name of the buyer
BuyerKey	UUID of the buyer
ReceiverName	Who receives the item (for gifts)
ItemName	Product name
Amount	Price paid in L$
Type	order or gift

FAQ

Q: Do I need a Delivery Bot for ANS?
A: The SL Marketplace handles delivery itself. ANS just syncs the sale data to AvatarShot. The Delivery Bot is only needed for redelivery from the web.

Q: Can I use ANS and the Vendor Script together?
A: Yes! ANS tracks SL Marketplace sales, the Vendor Script tracks in-world sales. Both show up in your dashboard.

Q: What if a sale doesn't match a product?
A: The sale is still recorded with the item name and amount, but won't be linked to a specific product page. Add the SL Listing ID to fix this.

ANS Integration