Difference between revisions of "Accept.js by Authorize.net"

From WHMCS Documentation

m
Line 8: Line 8:
 
}}
 
}}
  
The WHMCS Official Accept.js by Authorize.net module was introduced in WHMCS 7.3.
+
The WHMCS Official Accept.js by <nowiki>Authorize.net</nowiki> module was introduced in WHMCS 7.3.
  
Accept.js is a tokenised gateway. As a result, customers personal credit card information is submitted to and stored remotely by Accept.js. Using a tokenised gateway is recommended for security and reduced liability.
+
Accept.js is a tokenised gateway. As a result, Accept.js stores customers' submitted personal credit card information remotely. We recommend using a tokenised gateway for security and reduced liability.
  
 
==Setup==
 
==Setup==
# Ensure that you have installed a valid SSL certificate for your site and that your system URL in ''Setup >> General Settings'' is configured to serve pages over SSL.
+
 
#* Your system URL should begin with "https" and visitors should be able to navigate your site without security acceptance prompts.
+
To set up this module:
# Begin by activating the '''Accept.js''' module in ''Setup > Payments > Payment Gateways''
+
 
# Accept.js uses API keys for authentication. Upon activation, you will be asked to enter the API Login ID, Transaction Key, and Public Client Key.
+
# Ensure that you have installed a valid SSL certificate for your site and that you have configured your system URL in '''Setup >> General Settings''' to [[Configuration|serve pages over SSL]]. Your system URL should begin with <tt>https</tt> and visitors should be able to navigate your site without security acceptance prompts.
#* These can be found or generated inside the Authorize.net portal under ''Account > Security Settings > API Credentials & Keys''
+
# Activate the '''Accept.js''' module in '''Setup > Payments > Payment Gateways'''.
# Customise the Display Name as desired, we recommend ''Accept by Authorize.net''
+
# When the system prompts you after activation, enter the '''API Login ID''', '''Transaction Key''', and '''Public Client Key'''. Accept.js uses API keys for authentication. You can find or generate these inside the Authorize.net portal under '''Account > Security Settings > API Credentials & Keys'''.
# Click '''Save Changes''' to complete the setup
+
# Customise the '''Display Name'''. We recommend <tt>Accept by Authorize.net</tt>.
 +
# Click '''Save Changes''' to complete the setup process.
  
 
Accept.js is now active and ready for use.
 
Accept.js is now active and ready for use.
  
<div class="docs-alert-warning">'''Warning:''' The Accept.js gateway module is not compatible with the Modern or Boxes order form templates.</div>
+
<div class="docs-alert-danger">
 +
<span class="title">Warning</span><br />
 +
The Accept.js gateway module is not compatible with the ''Modern'' or ''Boxes'' order form templates.
 +
</div>
  
 
==Payment Workflow==
 
==Payment Workflow==
# Automated recurring and on-demand billing is supported.
+
 
# When making a payment, customers are able to select to use a previously stored card or enter a new one.
+
This workflow supports automated recurring and on-demand billing.  
# Customers can update their credit card at any time from the client area.
+
 
# Admin level users with the necessary permissions can also perform card updates from the admin area.
+
When they pay, customers can choose to use a previously-stored card or enter a new one and can update their card at any time from the client area. Admin level users with the necessary permissions can also perform card updates from the admin area.
# Customers never leave your WHMCS installation during checkout or updating their card.
+
 
# Personal card information is submitted directly to Accept.js and is never stored in your local WHMCS installation.
+
* Within this workflow, customers never leave your WHMCS installation during checkout or when updating their card.
# The Accept.js API is used for obtaining transaction information.
+
* The system submits personal card information directly to Accept.js and never stores it on your local WHMCS installation.
# The Accept.js.js library is used for payments and card updates.
+
 
 +
The system uses the Accept.js API for obtaining transaction information, and uses the Accept.js.js library for payments and card updates.
  
 
==Migrating to Accept.js==
 
==Migrating to Accept.js==
  
Our Accept.js module supports migrating credit card details stored locally within WHMCS to the Accept.js tokenisation system. This allows for a seamless transition from another merchant gateway provider to Accept.js.
+
Our Accept.js module supports migrating credit card details from WHMCS to the Accept.js tokenisation system. This allows for a seamless transition from another merchant gateway provider to Accept.js.
  
Migration of existing clients' locally stored credit card data occurs during the next payment process per client. The first time a payment capture is attempted for an invoice using Accept.js, the credit card details will be submitted to Accept.js and a token created and stored. Any card details stored locally for that client will be removed.
+
Migration of existing clients' locally-stored credit card data occurs during the next payment process for each client. The first time the system attempts a payment capture for an invoice using Accept.js, the system will submit credit card details to Accept.js and create and store a token. The system will remove any locally-stored card details for that client.
  
 
To migrate all of your credit card processing to Accept.js, follow the steps below:
 
To migrate all of your credit card processing to Accept.js, follow the steps below:
  
# Navigate to ''Setup > Payments > Payment Gateways''
+
# Navigate to '''Setup > Payments > Payment Gateways'''.
# Ensure the Accept.js module has been activated
+
# Ensure that you have activated the Accept.js module.
# Select the '''Deactivate''' link for your previous merchant gateway provider
+
# Select the '''Deactivate''' link for your previous merchant gateway provider.
# When prompted to choose a replacement gateway to switch users of the previous gateway module to, select Accept.js
+
# When the system prompts you, select ''Accept.js''.
# Click '''OK''' to complete the process
+
# Click '''OK''' to complete the process.
  
<div class="docs-alert-info">'''Note:''' Existing credit card details stored locally will be sent to Accept.js and converted to a token the first time a payment is attempted for a client using the Accept.js module. Until that time, credit card details will remain stored locally within WHMCS.</div>
+
<div class="docs-alert-info">
 +
<span class="title">Note</span><br />
 +
The system will send existing locally-stored credit card details to Accept.js and convert them to a token the first time that the client attempts a payment using the Accept.js module. Until that time, locally-stored credit card details will remain within WHMCS.</div>

Revision as of 16:42, 18 May 2020

Supported Features

Type One Time Recurring Refunds 3D Secure
Token Yes Yes Yes No
Remote Update Card Remote Delete Card AddPayMethod API
Yes Yes No

The WHMCS Official Accept.js by Authorize.net module was introduced in WHMCS 7.3.

Accept.js is a tokenised gateway. As a result, Accept.js stores customers' submitted personal credit card information remotely. We recommend using a tokenised gateway for security and reduced liability.

Setup

To set up this module:

  1. Ensure that you have installed a valid SSL certificate for your site and that you have configured your system URL in Setup >> General Settings to serve pages over SSL. Your system URL should begin with https and visitors should be able to navigate your site without security acceptance prompts.
  2. Activate the Accept.js module in Setup > Payments > Payment Gateways.
  3. When the system prompts you after activation, enter the API Login ID, Transaction Key, and Public Client Key. Accept.js uses API keys for authentication. You can find or generate these inside the Authorize.net portal under Account > Security Settings > API Credentials & Keys.
  4. Customise the Display Name. We recommend Accept by Authorize.net.
  5. Click Save Changes to complete the setup process.

Accept.js is now active and ready for use.

Warning
The Accept.js gateway module is not compatible with the Modern or Boxes order form templates.

Payment Workflow

This workflow supports automated recurring and on-demand billing.

When they pay, customers can choose to use a previously-stored card or enter a new one and can update their card at any time from the client area. Admin level users with the necessary permissions can also perform card updates from the admin area.

  • Within this workflow, customers never leave your WHMCS installation during checkout or when updating their card.
  • The system submits personal card information directly to Accept.js and never stores it on your local WHMCS installation.

The system uses the Accept.js API for obtaining transaction information, and uses the Accept.js.js library for payments and card updates.

Migrating to Accept.js

Our Accept.js module supports migrating credit card details from WHMCS to the Accept.js tokenisation system. This allows for a seamless transition from another merchant gateway provider to Accept.js.

Migration of existing clients' locally-stored credit card data occurs during the next payment process for each client. The first time the system attempts a payment capture for an invoice using Accept.js, the system will submit credit card details to Accept.js and create and store a token. The system will remove any locally-stored card details for that client.

To migrate all of your credit card processing to Accept.js, follow the steps below:

  1. Navigate to Setup > Payments > Payment Gateways.
  2. Ensure that you have activated the Accept.js module.
  3. Select the Deactivate link for your previous merchant gateway provider.
  4. When the system prompts you, select Accept.js.
  5. Click OK to complete the process.

Note

The system will send existing locally-stored credit card details to Accept.js and convert them to a token the first time that the client attempts a payment using the Accept.js module. Until that time, locally-stored credit card details will remain within WHMCS.