Difference between revisions of "X-Cart:Authorize.Net"
(Created page with 'Authorize.Net is a large U.S.-based payment gateway that allows you to accept online credit card and electronic check payments. The claimed user base of more than 230, 000 mercha…') |
|||
| Line 1: | Line 1: | ||
| − | Authorize.Net is a large U.S.-based payment gateway that allows you to accept online credit card and electronic check payments. The claimed user base of more than 230, 000 merchants makes it one of the largest internet payment service providers. X-Cart is currently integrated with two payment methods offered by Authorize.Net: Server Integration Method (SIM) and Advanced Integration Method (AIM). The major difference between the two methods is where you host the payment pages for you store. | + | Authorize.Net is a large U.S.-based payment gateway that allows you to accept online credit card and electronic check payments. The claimed user base of more than 230,000 merchants makes it one of the largest internet payment service providers. X-Cart is currently integrated with two payment methods offered by Authorize.Net: Server Integration Method (SIM) and Advanced Integration Method (AIM). The major difference between the two methods is where you host the payment pages for you store. |
A third Authorize.Net's payment option supported by X-Cart is <u>Authorize.Net: AIM. eCheck</u>, which is an implementation of Authorize.Net: AIM for electronic check payments. | A third Authorize.Net's payment option supported by X-Cart is <u>Authorize.Net: AIM. eCheck</u>, which is an implementation of Authorize.Net: AIM for electronic check payments. | ||
| Line 21: | Line 21: | ||
If you have not yet registered an account with Authorize.Net, you should do it before you start setting up Authorize.Net in X-Cart. To open an account, go to the Authorize.Net website at [http://www.authorize.net/signupnow/ http://www.authorize.net/signupnow/] and follow the instructions on the screen. After you have registered an account, you can set up Authorize.Net: SIM, Authorize.Net: AIM and Authorize.Net: AIM. eCheck in the X-Cart Admin area. | If you have not yet registered an account with Authorize.Net, you should do it before you start setting up Authorize.Net in X-Cart. To open an account, go to the Authorize.Net website at [http://www.authorize.net/signupnow/ http://www.authorize.net/signupnow/] and follow the instructions on the screen. After you have registered an account, you can set up Authorize.Net: SIM, Authorize.Net: AIM and Authorize.Net: AIM. eCheck in the X-Cart Admin area. | ||
| + | |||
| + | ==Setting up Authorize.Net to work with X-Cart== | ||
| + | |||
| + | ===Setting up Authorize.Net in X-Cart v4.x=== | ||
| + | |||
| + | ====Authorize.Net: AIM==== | ||
| + | |||
| + | In X-Cart admin zone go to the 'Payment methods' page. Use 'Payment gateways' form to add Authorize.Net:AIM to your list of payment methods. After it has been added to the payment methods box, click the 'Configure' link next to the name of this CC processor to access Authorize.Net:AIM settings dialog. | ||
| + | |||
| + | You should complete the following fields: | ||
| + | |||
| + | * Account type (Authorize.Net or Wells Fargo). | ||
| + | * API Login ID | ||
| + | * Transaction key | ||
| + | * Currency | ||
| + | * MD5 hash value | ||
| + | * Test/Live mode | ||
| + | * Order prefix | ||
| + | |||
| + | You should receive your Login ID and Transaction key from Authorize.Net. MD5 hash value is set up in your merchant account. | ||
| + | |||
| + | ====Authorize.Net:SIM==== | ||
| + | |||
| + | In X-Cart admin zone go to the 'Payment methods' page. Use 'Payment gateways' form to add Authorize.Net:SIM to your list of payment methods. After it has been added to the payment methods box, click the 'Configure' link to access Authorize.Net:SIM settings dialog. | ||
| + | |||
| + | You should complete the following fields: | ||
| + | |||
| + | * API Login ID | ||
| + | * Transaction key | ||
| + | * Timezone offset in hours (difference between the time zone of the server and GMT) <- NOTE: you should set 0 (zero) value in this field. Basically timezone offset should be in seconds, however there is a bug in X-Cart that disables this feature, it is fixed in v4.1.9. | ||
| + | * Currency | ||
| + | * Test/Live mode | ||
| + | * Order prefix | ||
| + | |||
| + | Then you should configure your Authorize.Net merchant account. Under Settings -> 'Response/Receipt URLs', click 'Add URL' button and enter the URL defined in the X-Cart admin back-end, on "Authorize.Net: SIM" settings page: "Valid Referrer URL" field. | ||
| + | Also you should ensure the following parameters are set under Settings-> Direct Response: | ||
| + | - Direct Response Delimited Response: Yes | ||
| + | - Default Field Separator: ,(comma) | ||
| + | |||
| + | ==Setting up Authorize.Net in X-Cart 3.4.x and 3.5.x== | ||
| + | |||
| + | Go to 'CC/ACH processing' menu, select 'Authorize.net' as an active CC processor, click 'Continue' and fill in the settings form. Enter merchant login and transaction key. Choose the currency and enter order prefix. | ||
| + | |||
| + | Then log in to your Authorize.net merchant account. Go to Settings -> 'Response/Receipt URLs', click 'Add URL' button and enter the following URL: http://www.yoursite.com/xcart_directory/customer/home.php (POST method) Also check that the following parameters are set under Settings-> Direct Response: | ||
| + | - Direct Response Delimited Response: Yes | ||
| + | - Default Field Separator: ,(comma) | ||
| + | |||
| + | ==Troubleshooting== | ||
| + | |||
| + | ===If Autorize.Net is successfully contacted but there is an error you will get an error message.=== | ||
| + | |||
| + | It can be found on the error message page (in earlier versions, in the browser address string), so you will know what is wrong. | ||
| + | |||
| + | ===If Authorize.Net replies that certain field cannot be left empty=== | ||
| + | |||
| + | then you should do the following: login to your merchant account, go to 'Settings' -> 'Payment Form' -> Form fields and uncheck 'Required checkbox' next to this field. Another possible cause of orders declining is that AVS checking is too strict. Go to 'Settings' -> 'Address Verification System Settings' and uncheck all Reject flags. | ||
| + | |||
| + | ===If you do not get any response from Authorize.Net=== | ||
| + | |||
| + | it means that Authorize.Net hasn't been contacted. | ||
| + | |||
| + | First, check if payment/authorize_net.pl has executable permissions. If it doesn't, run the shell/ftp command - chmod 0755 authorize_net.pl. The second possible cause: Net::SSLeay Perl module is not installed. Refer to the corresponding FAQ item that explains Net::SSLeay Perl module installation. | ||
| + | |||
| + | Rarely happens: your Perl script may be distorted during its uploading to your server from Windows machine. If you edit Perl script in Windows editor (like NotePad), you should upload it in ASCII mode to convert Windows new line symbols to UNIX new line symbols. | ||
[[Category:X-Cart user manual]] | [[Category:X-Cart user manual]] | ||
Revision as of 11:39, 24 September 2010
Authorize.Net is a large U.S.-based payment gateway that allows you to accept online credit card and electronic check payments. The claimed user base of more than 230,000 merchants makes it one of the largest internet payment service providers. X-Cart is currently integrated with two payment methods offered by Authorize.Net: Server Integration Method (SIM) and Advanced Integration Method (AIM). The major difference between the two methods is where you host the payment pages for you store.
A third Authorize.Net's payment option supported by X-Cart is Authorize.Net: AIM. eCheck, which is an implementation of Authorize.Net: AIM for electronic check payments.
Contents
Authorize.Net: SIM (Server Integration Method)
With Authorize.Net: SIM the payment pages are hosted on the side of Authorize.Net, which means that Authorize.Net provides all the necessary resources to process a transaction, including collection of payment information. Customers get redirected to the Authorize.Net secure website and enter their card details there. Authorize.Net: SIM is a right solution if you do not have adequate resources to collect and transfer sensitive card details. For example, SIM does not require you to obtain and install an SSL certificate on your server/hosting account.
Authorize.Net: AIM (Advanced Integration Method)
With Authorize.Net: AIM the payment pages are hosted together with the rest of the store. The data is transmitted to Authorize.Net in the background mode and customers never leave your website during the purchase. Since Authorize.Net: AIM involves collection and transmission of sensitive cardholder data, you must ensure the security of this data by setting up secure connection with Authorize.Net. Otherwise, Authorize.Net will reject the transaction.
Secure connection is implemented through an SSL certificate installed on your server/hosting account. For recommended SSL certificate providers please check the X-Cart marketplace at http://marketplace.x-cart.com/ . Another requirement of Authorize.Net: AIM is that your server must provide support for at least one of the following HTTPS modules: Net::SSLeay, CURL, libCURL, OpenSSL or HTTPS-cli.
Authorize.Net: AIM. eCheck
Authorize.Net: AIM. eCheck uses the same logic as Authorize.Net: AIM, but it is meant to process electronic check payments - not credit card payments. Like Authorize.Net: AIM, the eCheck implementation also requires an SSL certificate and one of the supported HTTPS modules.
Obtaining an Authorize.Net account
If you have not yet registered an account with Authorize.Net, you should do it before you start setting up Authorize.Net in X-Cart. To open an account, go to the Authorize.Net website at http://www.authorize.net/signupnow/ and follow the instructions on the screen. After you have registered an account, you can set up Authorize.Net: SIM, Authorize.Net: AIM and Authorize.Net: AIM. eCheck in the X-Cart Admin area.
Setting up Authorize.Net to work with X-Cart
Setting up Authorize.Net in X-Cart v4.x
Authorize.Net: AIM
In X-Cart admin zone go to the 'Payment methods' page. Use 'Payment gateways' form to add Authorize.Net:AIM to your list of payment methods. After it has been added to the payment methods box, click the 'Configure' link next to the name of this CC processor to access Authorize.Net:AIM settings dialog.
You should complete the following fields:
- Account type (Authorize.Net or Wells Fargo).
- API Login ID
- Transaction key
- Currency
- MD5 hash value
- Test/Live mode
- Order prefix
You should receive your Login ID and Transaction key from Authorize.Net. MD5 hash value is set up in your merchant account.
Authorize.Net:SIM
In X-Cart admin zone go to the 'Payment methods' page. Use 'Payment gateways' form to add Authorize.Net:SIM to your list of payment methods. After it has been added to the payment methods box, click the 'Configure' link to access Authorize.Net:SIM settings dialog.
You should complete the following fields:
- API Login ID
- Transaction key
- Timezone offset in hours (difference between the time zone of the server and GMT) <- NOTE: you should set 0 (zero) value in this field. Basically timezone offset should be in seconds, however there is a bug in X-Cart that disables this feature, it is fixed in v4.1.9.
- Currency
- Test/Live mode
- Order prefix
Then you should configure your Authorize.Net merchant account. Under Settings -> 'Response/Receipt URLs', click 'Add URL' button and enter the URL defined in the X-Cart admin back-end, on "Authorize.Net: SIM" settings page: "Valid Referrer URL" field. Also you should ensure the following parameters are set under Settings-> Direct Response: - Direct Response Delimited Response: Yes - Default Field Separator: ,(comma)
Setting up Authorize.Net in X-Cart 3.4.x and 3.5.x
Go to 'CC/ACH processing' menu, select 'Authorize.net' as an active CC processor, click 'Continue' and fill in the settings form. Enter merchant login and transaction key. Choose the currency and enter order prefix.
Then log in to your Authorize.net merchant account. Go to Settings -> 'Response/Receipt URLs', click 'Add URL' button and enter the following URL: http://www.yoursite.com/xcart_directory/customer/home.php (POST method) Also check that the following parameters are set under Settings-> Direct Response: - Direct Response Delimited Response: Yes - Default Field Separator: ,(comma)
Troubleshooting
If Autorize.Net is successfully contacted but there is an error you will get an error message.
It can be found on the error message page (in earlier versions, in the browser address string), so you will know what is wrong.
If Authorize.Net replies that certain field cannot be left empty
then you should do the following: login to your merchant account, go to 'Settings' -> 'Payment Form' -> Form fields and uncheck 'Required checkbox' next to this field. Another possible cause of orders declining is that AVS checking is too strict. Go to 'Settings' -> 'Address Verification System Settings' and uncheck all Reject flags.
If you do not get any response from Authorize.Net
it means that Authorize.Net hasn't been contacted.
First, check if payment/authorize_net.pl has executable permissions. If it doesn't, run the shell/ftp command - chmod 0755 authorize_net.pl. The second possible cause: Net::SSLeay Perl module is not installed. Refer to the corresponding FAQ item that explains Net::SSLeay Perl module installation.
Rarely happens: your Perl script may be distorted during its uploading to your server from Windows machine. If you edit Perl script in Windows editor (like NotePad), you should upload it in ASCII mode to convert Windows new line symbols to UNIX new line symbols.
