Table of Contents

Overview

Payment Handlers allows you to set up a Authorize.Net, PayPal Payflow Pro, or NMI (Acumen) payment handler. Payment handlers are third party services used to process credit card payments on the site.


Note:  If you are accepting Credit Card payments and the User did not specify a Country in the address field on the form, by default, the Payment Handler that is used to process Credit Card Transactions will enter U.S. as the Country.

Note: Payment handlers are used with the following:


ACCESSING APPLICATIONS

From the drop-down in the the upper left choose Settings / FTP Payment handlers...


NOTE: Not sure how to access BLOX Applications? Click here


Workspace Layout

This will bring up the Payment Handlers window. The toolbar is where you can Add, Edit, or Delete payment handlers. Column Headers display the Name, Driver, and the Username.

+8 
PayHandlersMain.jpg

Add/Edit a Payment Handler

To Create a new Payment Handler, click New. This will open the Create Payment Handler window. Go to Step Two.

To Edit a Payment Handler, select the payment handler you would like to edit, and click Edit. This will open the Edit Payment Handler window. Go to Step Three.

When you click on New, the Create a Payment Handler window opens.

+8 
payment handler type.png

1 Name - Give the Payment Handler a name (Required).

2 Authorize.Net - This type does not support recurring transactions in BLOX CMS. 

3 Paypal Payflow Pro - This type supports recurring payments and can be used with recurring Subscription Services.

4 NMI (Acumen) - This type does not support recurring transactions. Cannot be used for recurring Subscription payments. The Payment Gateway Interface can be accessed via: http://www.acumenprocessing.com/


WARNING: If you attempt to cancel the subscription within that three day period, the subscription will be cancelled BUT the transaction will still be processed (up to three times).

Ex: A customer calls and asks to cancel their subscription because they know they will not have sufficient funds to cover the payment. If this is withing the three day period the transaction process will already have started and cannot be stopped. Therefore the customer could receive three separate attempts on their bank account and any bank charges related to insufficient funds.


Click Continue.

 This opens the Edit Payment Handler window. Their will be different fields and options depending on what Payment Handler Type you chose.

+8 
PayHandlersEdit.jpg

There are two components to setting up a Payment Handler:

  • Configuration - The name is populated into the Handler Name field as well as the Driver type you selected. Username and Password are required. CSC and AVS, if checked, will check for accurate credit card and address information is supplied.
  • Card Types - Click on Add and you can apply the type(s) of credit cards that are allowed.
+8 
PmtHand_IssuersSpreedly

Authorize.Net

+8 
Authorize

1 Handler Name: This is the Name you created in Step Two.

2 Driver: This is the Type you choose in Step Two.

3 Username: This is your Authorize.net API Login ID.

4 Password: This is your Authorize.net Transaction Key.


Note: You need to set up an account with Authorize.net to obtain credentials. For information on what an Authorize.net API Login ID and Transaction Key is, Click Here. For information on how to find your Authorize.net API Login ID and Transaction Key (or update your Transaction Key), Click Here.


5 Sandbox Account: Authorize.net designates accounts as either live or sandbox. If you have a sandbox account, you should check this box. Sandbox accounts are only for testing and are generally not used by most customers.

6 Currency (Required): Select the currency you are using.

7 AVS: (Address Verification Service) - Check this box if your service requires the AVS information to process the transaction.


Note: The Address Verification Service (AVS) is a 3 or 4 digit number printed on the back of a credit card (typically in the signature field). The number appears only on the card itself (not on receipts or statements) so it can provide some indication that the physical card is in the possession of the buyer.  If using PayPal Payflow Pro as the payment handler, this box should be checked.


PayPal Payflow Pro

+8 
PayPal

1 Handler Name: This is the Name you created in Step Two.

2 Driver: This is the Type you choose in Step Two.

3 Username: This is the username of your PayPal PayFlow Pro account.

4 Password: This is the password of your PayPal PayFlow Pro account.


Note: If you are using Paypal Payflow Pro and TownNews is your partner, we can help you recover your username and password. Please contact TownNews Customer Support for this.

To make use of Payflow Pro user accounts (where the main account credentials are not being used), you must create a user account with your PayPal admin that has the role API_FULL_TRANSACTIONS assigned to it. API_FULL_TRANSACTIONS is a Paypal Payflow Pro permissions setting which allows you to use a different Paypal User Account that does not have access permissions, to connect with BloxCMS Payment Handler.  Additionally, that PayPal username should then be used in the BLOX payment handler 'username' field and the main PayPal username should be moved to the BLOX 'Vendor' field.   See example below.

Note: If you are using multiple user accounts, per PayPal, you need to be using PayPal PayFlow Pro Version 2 and also have a PayPal Manager account set up.


5 Partner: is the name of the reseller from which the customer purchased Paypal Payflow Pro service.

6 Vendor: is the core Payflow Pro account username. It is required only if the customer created a separate username for the API to use.

7 Currency (Required): Select the currency you are using.

8 AVS Required:  check this box if your service requires the AVS information to process the job.


Note: The Address Verification System (AVS) is a system used to verify the identity of the person claiming to own the credit card. The system will check the billing address of the credit card provided by the user with the address on file at the credit card company.  If using NET1 (Sage Payment Solutions) as the payment handler, this box should be checked.


Click Save.

NMI (Acumen)

+8 
Acumen

1 Handler Name: This is the Name you created in Step Two.

2 Driver: This is the Type you choose in Step Two.

3 Username: This is the username of your NMI (Acumen) account.

4 Password: This is the password of your NMI (Acumen) account.


Note: Your username and password is available from the payment handler vendor.



Note: You can contact TownNews Customer Support by submitting a ticket through your BLOX admin (Support / Ticket for more information please see the Ticket Workspace doc) or by calling 800-293-9576.


5 Currency (Required): Select the currency you are using.

6 AVS Required:  check this box if your service requires the AVS information to process the job.


Note: The Address Verification System (AVS) is a system used to verify the identity of the person claiming to own the credit card. The system will check the billing address of the credit card provided by the user with the address on file at the credit card company.  If using NET1 (Sage Payment Solutions) as the payment handler, this box should be checked.


Delete a Payment Handler

Highlight the payment handler you would like to delete, click Delete.

+8 
PayHandlersDel.jpg

In the warning window click Yes to delete and No to cancel the process.

+8 
PayHandlersDelConfirm.jpg