NATS4 Vendo Services
NATS 4
|
|---|
Please don't test your biller setup with NATS4 Vendo Services's test account—it won't work correctly.
Set up on Vendo's Website
Before you can begin configuring Vendo Services as a biller in NATS4, you must first register a merchant account with them. This can be done through their website at http://www.vendoservices.com/.
When registering with Vendo, please let them know that you're working with NATS, so that they can better help you.
The Postback URL to NATS is:
- http://linkdomain/signup/process_vservices.php
After Vendo sets up your sites, they give you a document containing all the information you need to set up Vendo Services in NATS. It should contain your Merchant I.D., and Shared Secret. This information is currently in part A of your Vendo setup document. They should also give you a Site I.D. code for each of your sites, and an identifier, upgrade identifier, and package for each of your join options in Part E of your Vendo set up document.
If your Vendo Services "Polling Date" does not update to the correct date and time, please ensure your Vendo Services account is setup to send data in the correct format for NATS: On Vendo Services side, "Go to the Merchant configuration section and set Reconciliation Type to Legacy"
Set up Vendo Services in NATS
Billers Admin
To begin setting up Vendo Services as a biller in NATS, go to the Billers Admin. Scroll down to the "Biller" drop-down menu, select Vendo Services, and click "Add."
Note: If you don't see Vendo Services as a biller in NATS4, put in a support ticket, as you may need an updated version of NATS.
When prompted, fill in the Merchant ID, and Shared Secret that were provided to you by Vendo under the "Account Info" section. If you were not provided with this information, please contact your biller to receive it.
Sites Admin
Next, go to the Sites Admin, create or edit a tour, and scroll down to the "Biller Details" section. Enter your Vendo Site ID in the "VSERVICES Site Id" field, choose whether you wish to enable any of the optional Vendo Services features, and click Save.
Once you have done this, scroll down to the section labeled "Join Options for this Tour" and click the "Edit Option Details for this tour" icon that corresponds to the join option you wish to use. In the "Biller Codes" section on the next page, locate the "VSERVICES" settings. Enter your Vendo Services Identifier, Upgrade Identifier, and Package. If you did not receive this information, please contact Vendo.
Once you have configured these steps, save your join option details. Vendo Services will now be configured for basic use as a biller in NATS.
Cross Sales
Vendo also supports Cross Sale transactions through NATS. In order to process cross sale transactions, however, you will first have to set them up with Vendo. Please contact Vendo for assistance with this.
To set up cross sales in NATS, go to the Upsells Admin and click incoming or outgoing cross sales from the navigation tabs (depending on whether you are sending or receiving the cross sale).
If you are sending a cross sale to another site, go to the "Outgoing Cross Sales" section. Add Vendo Services from the Biller drop-down menu, and click Add New Option. On the next page, you will be prompted to fill in the Title, Description, and Disclaimer for your cross sell option.
You will then need to fill out the Biller Info for your cross sale, which should be provided to you by Vendo. Fill in your Offer ID, and Ref Code here, and click Save Changes.
If you are receiving the cross sale, go to the "Incoming Cross Sales" section. Add Vendo Services from the Biller drop-down menu and click Add New Option. When prompted, choose the site and program you want to associate with the cross sale.
Under "Details," fill in the title of your cross sale option, the initial membership fee and length, and the recurring membership fee and length. Finally, fill in your Offer ID in the "Biller Info" section and click Save Changes.
Notes
Targeting Billing Outside the U.S. and Canada
Go to Billers Admin, click the Add a Cascade tab, and enter a shortname. In the description field, enter the text your surfers will see on the pre-join form; for example: "Foreign Billing provided by Vendo." Set the Weight field to 256. In the Excluded list, select United States and Canada. Click Save Changes.
Find the cascade you just created and click the Expand Cascade icon. Click the Biller drop-down, select Vendo Services, and click Add. Make sure Vendo Services is the first biller in the cascade.
UpgradePlus
Vendo UpgradePlus lets you shorten a Member's trial by offering them incentives to upgrade in your Member's Area.
When processing UpgradePlus transactions through Vendo Services, you must use the following URL for your member transactions.
http://<linkdomain>/signup/upgradeplus.php?site=<siteid>&username=<username>
For more information on configuring UpgradePlus in NATS, please see our NATS4 Upgrade Plus wiki article.
SignupPlus
Vendo Services Signup Plus offering oneclick re-activation for expired membership.
When processing Signup Plus transactions through Vendo Services, you must use the following URL for your member transactions.
http://<linkdomain>/signup/signupplus.php?site=<siteid>&username=<username>
For more information on configuring Singupplus in Signup Plus, please see our Signup Plus wiki article.
Crypto & PIX
Vendo Services supports processing crypto and PIX transactions. This feature has not been directly integrated into NATS. For you to have these payment methods pre-selected on Vendo Payment page you will need to use the Nextra feature to attach the additional variable Vendo needs when the surfer selects a non-recurring join option on your pre-join page.
For more information on configuring a Nextra field can be found in this wiki article: NATS4 Extra Biller Fields
For Crypto
<input type="hidden" name="nextra[VSERVICES][pm]" value="crypto">
For PIX
<input type="hidden" name="nextra[VSERVICES][pm]" value="PIX">
For Pay by Bank
<input type="hidden" name="nextra[VSERVICES][pm]" value="PI">
Additional Information
Under the Configuration Admin Setting (Biller section), there config setting name "NO_CREATE_AUTOMATIC_MEMBER_VSERVICES" which will allow member not being create during the autocasacde. If you enable this feature setting, then additional affiliate tracking feature NATS4_Additional_Tracking will not work for all Vservices members.
Under the Configuration Admin Setting (Biller section), setting name "VSERVICES_ENABLE_AUTO_SYNC" will enable the auto sync feature for sites/options settings. You will be not allowed to modify the Vservices sites or options settings after you enable, as the VServices fields will auto fill the information in NATS via the Vendo Services sync API.
