NATS4 Shopping Cart Sales

From TMM Wiki
Revision as of 11:17, 10 December 2019 by Tmmcho (talk | contribs)
Jump to navigationJump to search
NATS 4
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers
NATS Extras
TMMid
Gallery Builder Module
CAPTCHA
Remote Affiliate Authentication
Build Your Own Anything Module
Shopping Cart Sales
Moving Tours, Members' Area, and Galleries
Admin Areas
Extended Sales
NATS Code Wordpress Plugin
Error_message_display
ATVOD Verification Process

Shopping Cart Integration

Too Much Media can integrate your Shopping Cart. For more information on the cost of an integration, please open a support ticket. You can forgo our integration fee by doing it yourself, but please keep in mind that there will be an hourly charge for any support required during or as a result of this process.

Integration of a shopping cart should follow these guidelines:

  • Landing pages of the shopping cart need to create a NATS cookie and a NATS session variable with an expiration date. (normally 7-30 days)
  • When an order is placed the NATS cookie expiration should be extended. (normally 5 years)
  • Nats code needs to be stored in the shopping cart database with both the customer record and the order record.
  • When posting orders to NATS, the NATS code stored with the customer record should be preferred to the code stored with the order.

Billers Admin

If you wish to configure a Shopping Cart Sales site, you must first start at the Billers Admin. Go to the Billers Admin, scroll to the bottom of the page, and select "Shopping Cart" from the Setup New Biller drop-down menu. When prompted, enter a shortname for your shop in the "Shop ID" field.

Sites Admin (Optional)

To further configure your Shopping Cart site, go to the Sites Admin and click the "Add a Site" tab at the top of the page. On the next page, choose the "Store" Site Type, fill in the site name, and short name (what you made Shop ID).

When you are done filling out the details, click Save Changes. This site and tour will now be associated with your Shopping Card biller option.

Configuration

Add the following line to nats/includes/config.php:

$config['SHOP_ALLOWED_IPS'] = Array('123.123.123.123');

Replace the IP address inside the single quotes with the IP address of your shopping cart.

Shopping Cart Post Parameters

The following parameters are required to be posted to the signup/process_shop.php script on your NATS domain. Without doing so, your shopping cart sales will not be properly processed.

  • nats - The NATS code of this sale
  • amount - The amount of the sale in cents ($5.00 should be sent in as 500).
  • transid - The ID of the transaction from inside the shopping cart.
  • shop_id -- the Shop ID of a shopping cart you setup in the Billers Admin (Not the Biller ID, but the Account Info)

Extra Parameters

You can send the following extra parameters for additional information:

  • site_id -- register the sale under this site (used when a natscode isn't present). Set via the field "SHOP(id:NUMBER) Site:" under "Biller Details" in the "Edit Tour" page. Can be set to any arbitrary number or word for each individual tour.
  • action -- "SALE" to register a new sale. Either "chargeback" or "credit" registers a chargeback or credit for that transaction ID number (transid)
  • username - you can send the shopper's username along and NATS will record the sale under their account.
  • ip - The IP address of the surfer doing the sale.
  • password
  • email
  • firstname
  • lastname
  • address1
  • address2
  • zip
  • city
  • state
  • country - an ISO two letter code
  • shipping_firstname
  • shipping_lastname
  • shipping_address1
  • shipping_address2
  • shipping_zip
  • shipping_city
  • shipping_state
  • shipping_country - an ISO two letter code
  • custom1
  • custom2
  • custom3
  • custom4
  • custom5
  • passthrough1
  • passthrough2
  • passthrough3
  • passthrough4
  • passthrough5

Additional Config

PROCESS_SHOP_PASSTHROUGH_ORDER - Determines which set of passthroughs will be prioritized when processing shopping cart sales

1. From Postback

2. From existing member data