Difference between revisions of "Accept.js by Authorize.net"
From WHMCS Documentation
m |
|||
| Line 1: | Line 1: | ||
| + | == About this Module == | ||
| + | |||
| + | <div class="docs-alert-success"> | ||
| + | The WHMCS Official Accept.js by <nowiki>Authorize.net</nowiki> module was introduced in WHMCS 7.3. | ||
| + | </div> | ||
| + | |||
| + | 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. | ||
{{gateways | {{gateways | ||
| type = token | | type = token | ||
| Line 8: | Line 15: | ||
| AddPayMethod API = no | | AddPayMethod API = no | ||
}} | }} | ||
| + | == Adding the Accept.js by Authorize.net Payment Gateway == | ||
| − | + | To set up the Accept.js by Authorize.net payment gateway in WHMCS: | |
| − | + | ||
| − | + | # Ensure that you have installed a valid SSL certificate for your site and have configured your system URL in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' (or '''Setup > General Settings''' prior to WHMCS 8.0) 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. | |
| − | + | # Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Payment Gateways'''. | |
| − | + | # Choose the '''All Payment Gateways''' tab. | |
| − | + | # Click '''Authorize.net Accept.js'''. | |
| − | + | # Check '''Show on Order Form''' to display this payment method in the Client Area during checkout. | |
| − | + | # Enter the '''API Login ID''' and '''Transaction Key''' values. You can find these in your Authorize.net account at '''Account > Security Settings > API Credentials & Keys'''. | |
| − | # Ensure that you have installed a valid SSL certificate for your site and | + | # Enter your '''Public Client Key''' value. You can find this in your Authorize.net account at '''Account > Security Settings > Manage Public Client Key'''. |
| − | # | + | # Click '''Save Changes'''. |
| − | # | ||
| − | # | ||
| − | # Click '''Save Changes''' | ||
| − | |||
| − | |||
<div class="docs-alert-danger"> | <div class="docs-alert-danger"> | ||
| Line 30: | Line 33: | ||
</div> | </div> | ||
| − | ==Payment Workflow== | + | == Payment Workflow == |
This workflow supports automated recurring and on-demand billing. | This workflow supports automated recurring and on-demand billing. | ||
| Line 41: | Line 44: | ||
The system uses the Accept.js API for obtaining transaction information, and uses the Accept.js.js library 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 from 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. | ||
| Line 58: | Line 61: | ||
<span class="title">Note</span><br /> | <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> | 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> | ||
| + | |||
| + | == Troubleshooting == | ||
| + | |||
| + | ''N/A'' | ||
Revision as of 20:35, 18 March 2022
Contents
About this Module
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.
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 |
Adding the Accept.js by Authorize.net Payment Gateway
To set up the Accept.js by Authorize.net payment gateway in WHMCS:
- Ensure that you have installed a valid SSL certificate for your site and have configured your system URL in Configuration () > System Settings > General Settings (or Setup > General Settings prior to WHMCS 8.0) 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.
- Go to Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Products/Services > Payment Gateways.
- Choose the All Payment Gateways tab.
- Click Authorize.net Accept.js.
- Check Show on Order Form to display this payment method in the Client Area during checkout.
- Enter the API Login ID and Transaction Key values. You can find these in your Authorize.net account at Account > Security Settings > API Credentials & Keys.
- Enter your Public Client Key value. You can find this in your Authorize.net account at Account > Security Settings > Manage Public Client Key.
- Click Save Changes.
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:
- Navigate to Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Payments > Payment Gateways.
- Ensure that you have activated the Accept.js module.
- Select the Deactivate link for your previous merchant gateway provider.
- When the system prompts you, select Accept.js.
- Click OK to complete the process.
Note
Troubleshooting
N/A