Difference between revisions of "Extended Sales"
TMMStephenY2 (talk | contribs) |
TMMStephenY2 (talk | contribs) |
||
| Line 24: | Line 24: | ||
=== Billers Admin === | === Billers Admin === | ||
| − | To begin configuring your Extended Sales module, go to the [[NATS4 Billers Admin|Billers Admin]] in your NATS install. Go to the "Setup New Biller" drop-down menu, select "Extended Sales," and click Add. Give the biller a [[Ct#Shortname|shortname]] you | + | To begin configuring your Extended Sales module, go to the [[NATS4 Billers Admin|Billers Admin]] in your NATS install. Go to the "Setup New Biller" drop-down menu, select "Extended Sales," and click Add. Give the biller a [[Ct#Shortname|shortname]] to distinguish them, as [[NATS]] allows you to add multiple Extended Sales billers. |
=== Sites Admin === | === Sites Admin === | ||
| − | Go to [[Sites Admin]], | + | Go to the [[NATS4 Sites Admin|Sites Admin]] and create a new tour, or edit an already existing one. On the Edit Tour page, scroll down to the "Add Extended Site Details" section and enter the extended sales biller's shortname that you created above. |
| + | |||
| + | You can also optionally associate extended sales to this particular site by using a specific join option. To do so, go to the Edit Tour page and add or edit a join option. On the Join Options page, scroll down to the Extended Option Codes section and enter the extended sales biller's shortname that you previously specified. | ||
== Sending Extended Sales Postbacks == | == Sending Extended Sales Postbacks == | ||
| − | + | If properly configured, your reporting software should send information about any extended sales to the following URL: | |
* <nowiki>http://domain/signup/process_extended.php</nowiki> | * <nowiki>http://domain/signup/process_extended.php</nowiki> | ||
| − | + | Simply replace ''domain'' with your site's [[ct#Domain|domain]]. | |
| − | Your reporting software needs to send the following information to the above URL in a HTTP GET or POST | + | Your reporting software needs to send the following information to the above URL in a HTTP GET or POST: |
=== All Actions === | === All Actions === | ||
Arguments that are always required: | Arguments that are always required: | ||
| − | * extended_id: the extended sales biller shortname | + | * extended_id: the extended sales biller's shortname |
* site_id: the code you placed in the site setup for this extended biller | * site_id: the code you placed in the site setup for this extended biller | ||
| − | * action: SALE, CREDIT, or CHARGEBACK | + | * action: SALE, CREDIT, or CHARGEBACK (this is case-sensitive, capitals are required) |
=== SALE === | === SALE === | ||
| − | To pay affiliates for a new extended sale, set the | + | To pay your affiliates for a new extended sale, set the ''action'' parameter (described above) to "SALE". Sales will have the following extra parameters: |
Required argument for SALE: | Required argument for SALE: | ||
| − | * nats: The affiliate's [[natscode]] | + | * nats: The affiliate's [[Getting_The_NATSCode|natscode]] |
Optional arguments for SALE: | Optional arguments for SALE: | ||
| − | * username (NATS randomly | + | * username (NATS will randomly generate this if you don't send it) |
| − | * password (NATS randomly | + | * password (NATS will randomly generate this if you don't send it) |
* option_id: the code you setup for the specific join option in the Sites Admin | * option_id: the code you setup for the specific join option in the Sites Admin | ||
* transid: your reporting software's arbitrary transaction identifier | * transid: your reporting software's arbitrary transaction identifier | ||
| − | * extended_type: the id of the extended type | + | * extended_type: the id of the extended type set up in the config file by Too Much Media techs |
* amount: the amount of the extended sale (used in revenue share programs) | * amount: the amount of the extended sale (used in revenue share programs) | ||
| − | * currency (set to the NATS base currency if you don't send it) | + | * currency: the currency used for the transaction (automatically set to the NATS base currency if you don't send it) |
* email: the consumer's email address | * email: the consumer's email address | ||
* ip: the consumer's IP address | * ip: the consumer's IP address | ||
=== CREDIT or CHARGEBACK === | === CREDIT or CHARGEBACK === | ||
| − | + | If you would like to penalize affiliates for extended sales that have failed or not gone through, set the ''action'' parameter (described above) to CREDIT or CHARGEBACK to account for these. Credits and [[Ct#Chargeback|chargebacks]] contain the following extra parameters: | |
Required argument for CREDIT or CHARGEBACK: | Required argument for CREDIT or CHARGEBACK: | ||
| Line 74: | Line 76: | ||
A sale that includes a username, password, and transaction identifier sent using HTTP GET: | A sale that includes a username, password, and transaction identifier sent using HTTP GET: | ||
| − | * < | + | * <pre>http://example.com/signup/process_extended.php?extended_id=my_shortname&site_id=123&action=SALE&nats=xxxx&username&transid=my_identifier</pre> |
A credit reversing the above transaction: | A credit reversing the above transaction: | ||
| − | * < | + | * <pre>http://example.com/signup/process_extended.php?extended_id=my_shortname&site_id=123&action=CREDIT&transid=my_identifier</pre> |
Revision as of 15:38, 26 July 2010
Please note: the following article describes an add-on feature to NATS4. If you want this feature, please request it and we'll install it on your system.
The Extended Sales module is an add-on to NATS4 that lets you pay affiliates for events that occur outside the NATS system. For example, you can enable pay per lead problems using the Extended Sales module. This allows you to track outside events using your reporting software, and direct that software to send NATS essential information about the outside events. NATS will then process the incoming information and use it to pay the referring affiliate.
Setup
Before you can set up extended sales, Too Much Media must install the Extended Sales Module on your system. To do so, please submit a support ticket.
Configuration File
To begin, you must first add the IP address of any computer that runs your reporting software to the NATS configuration file: includes/config.php. In the configuration file, make each address an element in the $config['EXTENDED_ALLOWED_IPS'] array. For example:
$config['EXTENDED_ALLOWED_IPS'] = Array( '0' => '111.111.111.111', '1' => '222.222.222.222', '3' => '333.333.333.333' );
Formatting this line incorrectly will cause your NATS to break-- thus you should ensure that each entry is a single IP address: ranges, masks, and globs are not supported by this module. Also, make sure that you have placed a comma between each entry. NATS will not accept extended sales data from computers with IP addresses that are not defined in this configuration array.
Billers Admin
To begin configuring your Extended Sales module, go to the Billers Admin in your NATS install. Go to the "Setup New Biller" drop-down menu, select "Extended Sales," and click Add. Give the biller a shortname to distinguish them, as NATS allows you to add multiple Extended Sales billers.
Sites Admin
Go to the Sites Admin and create a new tour, or edit an already existing one. On the Edit Tour page, scroll down to the "Add Extended Site Details" section and enter the extended sales biller's shortname that you created above.
You can also optionally associate extended sales to this particular site by using a specific join option. To do so, go to the Edit Tour page and add or edit a join option. On the Join Options page, scroll down to the Extended Option Codes section and enter the extended sales biller's shortname that you previously specified.
Sending Extended Sales Postbacks
If properly configured, your reporting software should send information about any extended sales to the following URL:
- http://domain/signup/process_extended.php
Simply replace domain with your site's domain.
Your reporting software needs to send the following information to the above URL in a HTTP GET or POST:
All Actions
Arguments that are always required:
- extended_id: the extended sales biller's shortname
- site_id: the code you placed in the site setup for this extended biller
- action: SALE, CREDIT, or CHARGEBACK (this is case-sensitive, capitals are required)
SALE
To pay your affiliates for a new extended sale, set the action parameter (described above) to "SALE". Sales will have the following extra parameters:
Required argument for SALE:
- nats: The affiliate's natscode
Optional arguments for SALE:
- username (NATS will randomly generate this if you don't send it)
- password (NATS will randomly generate this if you don't send it)
- option_id: the code you setup for the specific join option in the Sites Admin
- transid: your reporting software's arbitrary transaction identifier
- extended_type: the id of the extended type set up in the config file by Too Much Media techs
- amount: the amount of the extended sale (used in revenue share programs)
- currency: the currency used for the transaction (automatically set to the NATS base currency if you don't send it)
- email: the consumer's email address
- ip: the consumer's IP address
CREDIT or CHARGEBACK
If you would like to penalize affiliates for extended sales that have failed or not gone through, set the action parameter (described above) to CREDIT or CHARGEBACK to account for these. Credits and chargebacks contain the following extra parameters:
Required argument for CREDIT or CHARGEBACK:
- transid: must match the original SALE's transid
Optional arguments for CREDIT or CHARGEBACK:
- amount
- currency (set to the NATS base currency if you don't send it)
Examples
A sale that includes a username, password, and transaction identifier sent using HTTP GET:
http://example.com/signup/process_extended.php?extended_id=my_shortname&site_id=123&action=SALE&nats=xxxx&username&transid=my_identifier
A credit reversing the above transaction:
http://example.com/signup/process_extended.php?extended_id=my_shortname&site_id=123&action=CREDIT&transid=my_identifier
