Difference between revisions of "NATS4 RevUpCard"

From TMM Wiki
Jump to navigationJump to search
m
 
Line 3: Line 3:
 
}}
 
}}
  
NATS4 version 4.0.32 and later supports [[Common Terms#Payment Dumps|payment dumps]] to a [http://www.revupcard.com RevUpCard] account. Users of NATS4 4.0.32 or greater should skip to the section [[#Configuring RevUpCard|Configuring RevUpCard]] below. Users of earlier NATS4 versions should enter an upgrade [http://clients.toomuchmedia.com/ support ticket] or follow the steps below.
+
[[NATS4]] version 4.0.32 and later supports [[Common Terms#Payment Dumps|payment dumps]] to a [http://www.revupcard.com RevUpCard] account, which is a pre-paid card that affiliate payments can be made out to.  
 +
 
 +
If you are a user of [[NATS4]] 4.0.32 or greater, you can skip to the section [[#Configuring RevUpCard|Configuring RevUpCard]] below, as the RevUpCard dump format will be included in your list of dump formats by default.
 +
 
 +
If you are a user of earlier [[NATS4]] versions lower than 4.0.32, you can follow the steps below. However, we recommend that you submit a upgrade [http://clients.toomuchmedia.com support ticket], as the current version of [[NATS]] will include many more features.
  
 
== Creating RevUpCard dump format ==
 
== Creating RevUpCard dump format ==
Dump formats are used to format and display your payment after they've
+
Dump formats are used in [[NATS]] to format and display your payment in a payment processor after they've been stored in the system. To view the currently available dump formats, go to the [[NATS4 Payments Admin|Payments Admin]] and click the Dump Formats tab at the top of the page.  
been stored. Go to Payments Admin and click the Dump Formats tab to view the current dump formats.
+
 
Create a dump format by typing in the name
+
To add a RevUpCard dump format, create a new dump format by entering a name under "New Dump Format Name" at the bottom of the page. You can also duplicate an existing dump format and edit it to your liking by clicking the "Create Duplicate Format" icon under the actions column.
under "New Dump Format" or you can edit an existing
 
one by clicking the Edit icon next to it.
 
  
* Name: RevUpCard CSV
+
'''Note''': [[NATS4]] no longer allows you to edit default payment dump formats, as we sometimes change or update the defaults from our side. If you wish to edit a default dump format, you can make a duplicate format which you can then edit to your liking.
* Dump Header:  
+
 
 +
When creating a new RevUpCard dump format, you should fill out the available fields like the following example:
 +
 
 +
* '''Name''': RevUpCard CSV
 +
* '''Dump Header''':  
 
<pre>
 
<pre>
 
"CardNo","DDANo","MemberId","Amount","Description","DOB","SSN","WorkPhone","PostalCode","PreAuthId"
 
"CardNo","DDANo","MemberId","Amount","Description","DOB","SSN","WorkPhone","PostalCode","PreAuthId"
 
</pre>
 
</pre>
  
* Entry Header: ''None.''
+
* '''Entry Header''': ''None.''
* Entry:
+
* '''Entry''':
 
<pre>
 
<pre>
 
"","{$affiliate.payvia.DDANo}","","{$total.total_amount/100|currency_format:2}","{$affiliate.payvia.memo}","","","","",""
 
"","{$affiliate.payvia.DDANo}","","{$total.total_amount/100|currency_format:2}","{$affiliate.payvia.memo}","","","","",""
 
</pre>
 
</pre>
  
* Entry Footer: ''None.''
+
* '''Entry Footer''': ''None.''
* Dump Footer: ''None.''
+
* '''Dump Footer''': ''None.''
  
Click save.
+
When you are done configuring the available fields, click Save to save your new dump format.
  
 
== Create RevUpCard PayVia ==
 
== Create RevUpCard PayVia ==
# In the [[Payments Admin]], click the Pay Via Options tab, enter ''RevUpCard CSV'' into the "New Pay Via Option" text box (at the bottom of the page), and click Add.
+
 
# Fill out:
+
The next step of configuring your new RevUpCard payment dump (before version 4.0.32) is creating a new [[Pay Via Types|Pay Via type]] to work with your new dump format.
## Pay Via Description: what affiliates will see as the name of the pay via type (RevUpCard)
+
 
## Allowable 'Minimum Payout' Choices: A comma-separated list of available minimum payout options for affiliates.
+
To setup a RevUpCard pay via type, go to the [[NATS4 Payments Admin|Payments Admin]], click the "Pay Via Types" tab at the top, enter ''RevUpCard CSV'' into the "New Pay Via Type Name" text box at the bottom of the page, and click Add.
## Cost Per Payout: The fee to charge affiliates per pay out sent. Make it zero to disable cost or make it negative to give affiliates a bonus for each payout.
+
 
## Dump Format to Use: Choose the appropriate dump format to use (explained later)
+
After you have added your new pay via type, you must configure the available fields. These include:
# Click save
+
 
 +
* '''Pay Via Type''' - The name for your new pay via type.
 +
* '''Description''' - The text your affiliates will see when choosing this pay via type.
 +
* '''Minimum Payout''' - A comma-separated list of available minimum payout options for affiliates.
 +
* '''Cost(+)/Bonus(-) Per Payout''' - Charges your affiliates (cost) or gives your affiliates a bonus (bonus) for using this pay via type. Set it at zero to disable costs, make it positive to charge affiliates for using this type, or make it negative to give your affiliates a bonus for using this type.
 +
* '''Dump Format''' - Choose what dump format you wish to use for this pay via type (in this case, your new RevUpCard format).
 +
 
 +
When you have finished configuring your new Pay Via type, click Save to add the type.
  
 
== Configuring RevUpCard ==
 
== Configuring RevUpCard ==
Click the Edit PayVia Fields button. From here, you'll be editing the pay via type's structure. You can add a new field to the structure by filling out the row and clicking Save.
 
  
* Name: DDANo
+
To further configure your new RevUpCard Pay Via type, go to the [[NATS4 Payments Admin|Payments Admin]] and click the Configure type icon next to your newly created RevUpCard pay via type. Here, you will be editing the pay via type's structure, as well as what information is required from affiliates.
* Type: Text
+
 
* Required: mark this checkbox
+
You can add new field to the structure by filling out the available sections. These include:
* Minimum: 16
+
 
* Maximum: 16
+
* '''Field Name''' - A short description of what the affiliate needs to fill out (ex. User ID, account number, address, etc.)
* Unique: mark this checkbox
+
* '''Type''' - Choose if you want the field to be a text box, or a multiple choice option.
* Check Function: alnum_number_check
+
* '''Required''' - Mark the field as necessary for affiliates to fill out.
 +
* '''Minimum''' - The minimum amount of characters allowed in this field.
 +
* '''Maximum''' - The maximum amount of characters allowed in this field.
 +
* '''Unique''' - Mark the field as needing to be unique from other field entries.
 +
* '''Check Function''' - Checks if the field was properly populated. For example, ''alnum_number_check'' will make sure that this field entry only contains numbers, and does not allow spaces.
 +
 
 +
To configure the necessary field(s) for your new RevUpCard Pay Via type, you should enter the following values:
 +
 
 +
* '''Name''': DDANo
 +
* '''Type''': Text
 +
* '''Required''': mark this checkbox
 +
* '''Minimum''': 16
 +
* '''Maximum''': 16
 +
* '''Unique''': mark this checkbox
 +
* '''Check Function''': alnum_number_check
  
Your [[ct#Affiliate|affiliates]] can now enter their RevUpCard account information and change their payment type to RevUpCard.
+
Your [[ct#Affiliate|affiliates]] will now be able to enter their RevUpCard account information and change their payment type to RevUpCard.

Revision as of 13:00, 27 July 2010

NATS 4
Payments Admin
The Payments Admin
Creating and Editing PayVia Options and Dump Formats
Pay Via Types
Check Functions
Payment Dump Entry Numbers
Bulk Invoice Import
Payment Dump Variables
Payment Periods
Payout Period Configuration
Manual Invoices
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

NATS4 version 4.0.32 and later supports payment dumps to a RevUpCard account, which is a pre-paid card that affiliate payments can be made out to.

If you are a user of NATS4 4.0.32 or greater, you can skip to the section Configuring RevUpCard below, as the RevUpCard dump format will be included in your list of dump formats by default.

If you are a user of earlier NATS4 versions lower than 4.0.32, you can follow the steps below. However, we recommend that you submit a upgrade support ticket, as the current version of NATS will include many more features.

Creating RevUpCard dump format

Dump formats are used in NATS to format and display your payment in a payment processor after they've been stored in the system. To view the currently available dump formats, go to the Payments Admin and click the Dump Formats tab at the top of the page.

To add a RevUpCard dump format, create a new dump format by entering a name under "New Dump Format Name" at the bottom of the page. You can also duplicate an existing dump format and edit it to your liking by clicking the "Create Duplicate Format" icon under the actions column.

Note: NATS4 no longer allows you to edit default payment dump formats, as we sometimes change or update the defaults from our side. If you wish to edit a default dump format, you can make a duplicate format which you can then edit to your liking.

When creating a new RevUpCard dump format, you should fill out the available fields like the following example:

  • Name: RevUpCard CSV
  • Dump Header:
"CardNo","DDANo","MemberId","Amount","Description","DOB","SSN","WorkPhone","PostalCode","PreAuthId"
  • Entry Header: None.
  • Entry:
"","{$affiliate.payvia.DDANo}","","{$total.total_amount/100|currency_format:2}","{$affiliate.payvia.memo}","","","","",""
  • Entry Footer: None.
  • Dump Footer: None.

When you are done configuring the available fields, click Save to save your new dump format.

Create RevUpCard PayVia

The next step of configuring your new RevUpCard payment dump (before version 4.0.32) is creating a new Pay Via type to work with your new dump format.

To setup a RevUpCard pay via type, go to the Payments Admin, click the "Pay Via Types" tab at the top, enter RevUpCard CSV into the "New Pay Via Type Name" text box at the bottom of the page, and click Add.

After you have added your new pay via type, you must configure the available fields. These include:

  • Pay Via Type - The name for your new pay via type.
  • Description - The text your affiliates will see when choosing this pay via type.
  • Minimum Payout - A comma-separated list of available minimum payout options for affiliates.
  • Cost(+)/Bonus(-) Per Payout - Charges your affiliates (cost) or gives your affiliates a bonus (bonus) for using this pay via type. Set it at zero to disable costs, make it positive to charge affiliates for using this type, or make it negative to give your affiliates a bonus for using this type.
  • Dump Format - Choose what dump format you wish to use for this pay via type (in this case, your new RevUpCard format).

When you have finished configuring your new Pay Via type, click Save to add the type.

Configuring RevUpCard

To further configure your new RevUpCard Pay Via type, go to the Payments Admin and click the Configure type icon next to your newly created RevUpCard pay via type. Here, you will be editing the pay via type's structure, as well as what information is required from affiliates.

You can add new field to the structure by filling out the available sections. These include:

  • Field Name - A short description of what the affiliate needs to fill out (ex. User ID, account number, address, etc.)
  • Type - Choose if you want the field to be a text box, or a multiple choice option.
  • Required - Mark the field as necessary for affiliates to fill out.
  • Minimum - The minimum amount of characters allowed in this field.
  • Maximum - The maximum amount of characters allowed in this field.
  • Unique - Mark the field as needing to be unique from other field entries.
  • Check Function - Checks if the field was properly populated. For example, alnum_number_check will make sure that this field entry only contains numbers, and does not allow spaces.

To configure the necessary field(s) for your new RevUpCard Pay Via type, you should enter the following values:

  • Name: DDANo
  • Type: Text
  • Required: mark this checkbox
  • Minimum: 16
  • Maximum: 16
  • Unique: mark this checkbox
  • Check Function: alnum_number_check

Your affiliates will now be able to enter their RevUpCard account information and change their payment type to RevUpCard.