View source for NATS4 DHD

{{NATS4 Manual
| show_billers_section = true
}}

{{Test Billers Disclaimer}}

== Setting up at DHD ==
Register an account with [http://www.dhdmedia.com DHD Media].

You must give DHD the following two URLs so they can communicate with your NATS.

* Soap Server: <nowiki>http://linkdomain/signup/process_dhd.php</nowiki>
* WSDL: <nowiki>http://linkdomain/signup/process_dhd.php?wsdl</nowiki>

Replace ''linkdomain'' with your [[Link Domain|linkdomain]].

DHD should provide you with a Domain, Merchant ID, Web Service Username, Web Service Password, and Web Service Role -- record these, you'll need them later.  DHD may also setup a website name, multiple currencies, and quick pay for return customers -- if they setup any of these, make a record of them too.

When you setup your products with DHD, you need to record each option's I.D.; if you setup purchase pages, record the purchase page I.D. numbers too.

== Setting up DHD in NATS ==
=== Billers Admin ===

To begin setting up DHD as a [[Ct#Biller|biller]] in [[NATS]], go to the [[NATS4 Billers Admin|Billers Admin]]. Scroll down to the "Biller" drop-down menu, select "DHDMedia", and click Add.

=== Sites Admin ===

Next, go to the [[NATS4 Sites Admin|Sites Admin]], create or edit a [[Ct#Tour|tour]], and scroll down to the "Biller Details" section. Enter your Domain, Merchant ID, Web Service Username, Web Service Password, and Web Service Role into the provided fields. 

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 [[Ct#Join Option|join option]] you wish to use. In the "Biller Codes" section on the next page, locate the "DHD" options and enter the various Purchase Page IDs and Product IDs that you recorded earlier for those [[Ct#Join Option|join options]].

Once you have completed these steps, save your [[Ct#Join Option|join option]] details. DHD will now be configured for basic use as a [[Ct#Biller|biller]] in [[NATS]].

=== Cross Sales ===
'''Note: This feature is available as of [[NATS4.1]]. If you are on a version of [[NATS4]] and would like to process [[Ct#Cross Sell|cross sales]], please [https://clients.toomuchmedia.com submit an upgrade ticket] to upgrade your [[NATS]] installation.

DHD also supports [[Ct#Cross Sell|Cross Sale]] transactions through [[NATS]]. In order to process cross sale transactions, however, you will first have to set them up with DHD. Please contact DHD 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 [[Ct#Site|site]], go to the "Outgoing Cross Sales" section. Add DHD 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 DHD. Fill in your Merchant ID, Product ID, and Ref Code here, and click Save Changes.

If you are receiving the cross sale, go to the "Incoming Cross Sales" section. Add DHD from the Biller drop-down menu and click Add New Option. When prompted, choose the [[Ct#Site|site]] and [[Ct#Program|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 Merchant ID, Product ID, Upgrade Product Page ID, and Upgrade Product ID in the "Biller Info" section and click Save Changes.

=== Upsells ===

'''Note: This feature is available as of [[NATS4.1]]. If you are on a version of [[NATS4]] and would like to process [[Ct#Upsell|upsells]], please [https://clients.toomuchmedia.com submit an upgrade ticket] to upgrade your [[NATS]] installation.

[[Ct#Upsell|Upsells]] can be configured similarly to cross sales in [[NATS]]. Like [[Ct#Cross_Sell|cross sales]], you will have to set up upsells first with DHD.

To set up [[Ct#Upsell|upsells]] in [[NATS]], go to the [[Upsells Admin]] and click incoming or outgoing upsells from the navigation tabs (depending on whether you are sending or receiving the upsell).

If you are sending the [[Ct#Upsell|upsell]], go to the Outgoing Upsells section. Add DHD 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 upsell.

You will then need to fill out the Biller Info for your upsell, which should be provided to you by DHD. Fill in your Product ID, Ref Code, Domain, whether you want to use HTTPS Post, whether this is the Master Merchant Account, and the Initial Amount of your upsell here, and click Save Changes.

If you are receiving the [[Ct#Upsell|upsell]], go to the "Incoming Upsells" section. Add DHD from the Biller drop-down menu and click Add New Option. When prompted, choose the site and program you want to associate with the upsell.

Under "Details," fill in the title of your upsell option, the initial membership fee and length, and the recurring membership fee and length. Finally, fill in your Merchant ID, Product ID, Upgrade Product Page ID, and Upgrade Product ID in the "Biller Info" section and click Save Changes.

=== Using Quick pay with DHD ===

[[NATS4]] offers a new feature to set up Quick pay options only for returning customers through DHD. To do so, navigate to the [[NATS4_Sites_Admin|sites admin]] and click Edit Tour Details. On this page, check the "Quick Pay For Return Customers" option for DHD to set up the option for that particular tour. Once this is done, you will have to manually pass the [[ct#Member|member's]] username and token hash (if the payment method is through NATS tokens). 

When this is configured, the Quick pay option set for the tour will automatically be used if the member has a prior DHD transaction in their record. If they have no prior records (new members), the Quick pay option will not be available for DHD.

=== Package Plus ===

The Package Plus feature is available after NATS4.1.4.1 for the DHD integration. This feature allows you to offer your members incentives to upgrade their memberships to a higher tier in your Members Area. For more information on Package Plus, visit the [[NATS4 Package Plus|Package Plus]] wiki.

[[Category:NATS4 Biller Instructions]]