X-Cart:CyberSource - Revision history

Mouse at 13:55, 22 July 2020

2020-07-22T13:55:25Z

Vladimir Gurinenko: Added version tags

2011-11-02T09:03:27Z

Added version tags

Seyfin at 05:32, 23 May 2011

2011-05-23T05:32:54Z

Seyfin: /* Setting up CyberSource Hosted Order Page */

2011-05-23T05:27:23Z

‎Setting up CyberSource Hosted Order Page

Seyfin: /* Troubleshooting */

2011-05-20T07:35:17Z

‎Troubleshooting

Seyfin: /* Troubleshooting */

2011-05-20T07:24:12Z

‎Troubleshooting

Seyfin: /* CyberSource Hosted Order Page: orderPage_signaturePublic INVALID error */

2011-05-20T06:54:15Z

‎CyberSource Hosted Order Page: orderPage_signaturePublic INVALID error

Seyfin at 06:38, 20 May 2011

2011-05-20T06:38:52Z

Admin at 08:36, 16 February 2011

2011-02-16T08:36:01Z

Ivka at 07:39, 12 April 2010

2010-04-12T07:39:52Z

@@ Line 13: / Line 13: @@
 == CyberSource SOAP toolkit API ==
-With CyberSource SOAP toolkit API the payment pages are hosted with the rest part of the store. The data is transmitted to CyberSource in the background mode and customers never leave your website during the purchase. Since the connection method uses SSL encryption, you must obtain and install an SSL certificate to your server/hosting account. For recommended SSL certificate providers please check the X-Cart marketplace at http://marketplace.x-cart.com/. Another requirement is that your server must provide support for any of the following HTTPS modules: Net::SSLeay, CURL, libCURL, OpenSSL or HTTPS-cli.
+With CyberSource SOAP toolkit API the payment pages are hosted with the rest part of the store. The data is transmitted to CyberSource in the background mode and customers never leave your website during the purchase. Since the connection method uses SSL encryption, you must obtain and install an SSL certificate to your server/hosting account. For recommended SSL certificate providers please check the X-Cart marketplace at https://marketplace.x-cart.com/. Another requirement is that your server must provide support for any of the following HTTPS modules: Net::SSLeay, CURL, libCURL, OpenSSL or HTTPS-cli.
 ==Obtaining a CyberSource Account==
-If you have not registered an account with CyberSource yet, you should do it before you start setting up CyberSource in X-Cart. For instructions on how to open an account contact a CyberSource representative using the form at http://www.cybersource.com/contact_us/. After you have registered an account, you can set up CyberSource Hosted Order Page (HOP) and CyberSource SOAP toolkit API in the X-Cart Admin area.
+If you have not registered an account with CyberSource yet, you should do it before you start setting up CyberSource in X-Cart. For instructions on how to open an account contact a CyberSource representative using the form at https://www.cybersource.com/contact_us/. After you have registered an account, you can set up CyberSource Hosted Order Page (HOP) and CyberSource SOAP toolkit API in the X-Cart Admin area.
 ==Setting up CyberSource Hosted Order Page==
@@ Line 71: / Line 71: @@
 ) Update Keys and Certificates
-[http://www.cybersource.com/support_center/management/keyupdate/ http://www.cybersource.com/support_center/management/keyupdate/]
+[https://www.cybersource.com/support_center/management/keyupdate/ https://www.cybersource.com/support_center/management/keyupdate/]
 ) CyberSource instructions for updating your keys:
-[http://www.cybersource.com/resources/collateral/pdf/20010423_Certificate_Update_UG.pdf http://www.cybersource.com/resources/collateral/pdf/20010423_Certificate_Update_UG.pdf]
+[https://www.cybersource.com/resources/collateral/pdf/20010423_Certificate_Update_UG.pdf https://www.cybersource.com/resources/collateral/pdf/20010423_Certificate_Update_UG.pdf]
 ) Download: Update to ECert Application
-[http://apps.cybersource.com/cgi-bin/pages/additional.cgi?kit=Update_to_ECert_Application http://apps.cybersource.com/cgi-bin/pages/additional.cgi?kit=Update_to_ECert_Application]
+[https://apps.cybersource.com/cgi-bin/pages/additional.cgi?kit=Update_to_ECert_Application https://apps.cybersource.com/cgi-bin/pages/additional.cgi?kit=Update_to_ECert_Application]
 ==Troubleshooting==

@@ Line 1: / Line 1: @@
 {{Note1|This article describes setting up CyberSource for X-Cart 4.3.0 and above. To find out how to set up CyberSource for previous versions (4.0.0 - 4.2.x), read [[X-Cart:Setting_Up_Cybersource_for_previous_versions_%284.0.x,_4.1.x,_4.2.x%29 | this article]].}}
 ==Overview==
@@ Line 140: / Line 142: @@
 [[Category:X-Cart user manual]]
 [[Category:Payment gateways]]
 [[Category:X-Cart user manual]]
 [[Category:Payment gateways]]

@@ Line 23: / Line 23: @@
 # Log in to the X-Cart Admin area.
 # Go to the <u>Payment methods</u> section (Administration menu -> Payment methods) and scroll down to the <u>Payment gateways</u> form.
-# Select CyberSource (hosted page) from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_cybersource_01.gif|640px]]<br><br>After you have clicked on Add, CyberSource Hosted Order Page will be added to the list of the available payment methods.<br><br>[[Image:pg_cybersource_02.gif|640px]]<br>{{Note1|Note: If you set up a payment method providing online credit card payment processing and do not intend to process credit card payments manually, you should disable the default "Credit Card" payment method, that requires manual payment processing, by unselecting the check box next to the payment method's name. Additionally, you can change the default "Credit Card" payment method's name to "Credit Card (offline)", and change the online payment method's name to "Credit Card". This will help you to avoid any confusion between these two payment methods.}}{{Note1|The $store_cc variable in the config.php file must be set to false in case you disable the default 'Credit Card' payment method and do not intend to process credit card payments manually.}}
+# Select CyberSource (hosted page) from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_cybersource_01.gif|640px]]<br><br>After you have clicked on Add, CyberSource Hosted Order Page will be added to the list of the available payment methods.<br><br>[[Image:pg_cybersource_02.gif|640px]]<br>{{Note1|Note: If you set up a payment method providing online credit card payment processing and do not intend to process credit card payments manually, you should disable the default "Credit Card" payment method, that requires manual payment processing, by unselecting the check-box next to the payment method's name. Additionally, you can change the default "Credit Card" payment method's name to "Credit Card (offline)", and change the online payment method's name to "Credit Card". This will help you to avoid any confusion between these two payment methods.}}{{Note1|The $store_cc variable in the config.php file must be set to false in case you disable the default 'Credit Card' payment method and do not intend to process credit card payments manually.}}
 # Click on the Configure link. This opens the configuration page for CyberSource Hosted Order Page.<br><br>[[Image:pg_cybersource_03.gif|551px]]
 # Adjust the configuration settings for CyberSource Hosted Order Page and click the Update button to apply the changes.
@@ Line 46: / Line 46: @@
 # Log in to the X-Cart Admin area.
 # Go to the <u>Payment methods</u> section (Administration menu -> Payment methods) and scroll down to the <u>Payment gateways</u> form.
-# Select CyberSource (SOAP toolkit) from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_cybersource_05.gif|640px]]<br><br>After you have clicked on Add, CyberSource SOAP toolkit API will be added to the list of the available payment methods.<br><br>[[Image:pg_cybersource_06.gif|640px]]
+# Select CyberSource (SOAP toolkit) from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_cybersource_05.gif|640px]]<br><br>After you have clicked on Add, CyberSource SOAP toolkit API will be added to the list of the available payment methods.<br><br>[[Image:pg_cybersource_06.gif|640px]]<br>{{Note1|Note: If you set up a payment method providing online credit card payment processing and do not intend to process credit card payments manually, you should disable the default "Credit Card" payment method, that requires manual payment processing, by unselecting the check-box next to the payment method's name. Additionally, you can change the default "Credit Card" payment method's name to "Credit Card (offline)", and change the online payment method's name to "Credit Card". This will help you to avoid any confusion between these two payment methods.}}{{Note1|The $store_cc variable in the config.php file must be set to false in case you disable the default 'Credit Card' payment method and do not intend to process credit card payments manually.}}
 # Click on the Configure link. This opens the configuration page for CyberSource SOAP toolkit API.<br><br>[[Image:pg_cybersource_07.gif|529px]]
 # Adjust the configuration settings for CyberSource SOAP toolkit API and click the Update button to apply the changes.
@@ Line 138: / Line 138: @@
 In the same way, you can manually fill in the other fields - <u>Merchant ID</u> and <u>Serial number</u>.
 [[Category:X-Cart user manual]]
 [[Category:Payment gateways]]
 [[Category:X-Cart user manual]]
 [[Category:Payment gateways]]

@@ Line 23: / Line 23: @@
 # Log in to the X-Cart Admin area.
 # Go to the <u>Payment methods</u> section (Administration menu -> Payment methods) and scroll down to the <u>Payment gateways</u> form.
-# Select CyberSource (hosted page) from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_cybersource_01.gif|640px]]<br><br>After you have clicked on Add, CyberSource Hosted Order Page will be added to the list of the available payment methods.<br><br>[[Image:pg_cybersource_02.gif|640px]]
+# Select CyberSource (hosted page) from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_cybersource_01.gif|640px]]<br><br>After you have clicked on Add, CyberSource Hosted Order Page will be added to the list of the available payment methods.<br><br>[[Image:pg_cybersource_02.gif|640px]]<br>{{Note1|Note: If you set up a payment method providing online credit card payment processing and do not intend to process credit card payments manually, you should disable the default "Credit Card" payment method, that requires manual payment processing, by unselecting the check box next to the payment method's name. Additionally, you can change the default "Credit Card" payment method's name to "Credit Card (offline)", and change the online payment method's name to "Credit Card". This will help you to avoid any confusion between these two payment methods.}}{{Note1|The $store_cc variable in the config.php file must be set to false in case you disable the default 'Credit Card' payment method and do not intend to process credit card payments manually.}}
 # Click on the Configure link. This opens the configuration page for CyberSource Hosted Order Page.<br><br>[[Image:pg_cybersource_03.gif|551px]]
 # Adjust the configuration settings for CyberSource Hosted Order Page and click the Update button to apply the changes.

@@ Line 85: / Line 85: @@
 <pre>An error occurred while you submitted your order. If you are trying to make a purchase, please contact the merchant.</pre>
-In the table blow the error message, the API field 'orderPage_signaturePublic' that was sent in the request  is marked as INVALID.
+In the table which appears below the error message, the API field 'orderPage_signaturePublic' is marked as INVALID.
 <u>Solution:</u>
@@ Line 97: / Line 97: @@
 <pre>
 Script parse error. The following tokens must be retrieved from the script and inserted into the corresponding fields manually:
- - PublicKey
+- PublicKey
- - PrivateKey
+- PrivateKey
 </pre>
@@ Line 108: / Line 108: @@
 <pre>
-            'param05'    => 'PublicKey',
+'param05'    => 'PublicKey',
-            'param06'    => 'PrivateKey',
+'param06'    => 'PrivateKey',
 </pre>
@@ Line 115: / Line 115: @@
 <pre>
-            'param05'    => 'SharedSecret'
+'param05'    => 'SharedSecret'
 </pre>
@@ Line 138: / Line 138: @@
 In the same way, you can manually fill in the other fields - <u>Merchant ID</u> and <u>Serial number</u>.
 [[Category:X-Cart user manual]]
 [[Category:X-Cart user manual]]
@@ Line 157: / Line 175: @@
 [[Category:Payment gateways]]
 [[Category:X-Cart user manual]]
 [[Category:X-Cart user manual]]

@@ Line 29: / Line 29: @@
 #* <u>Test/Live mode</u>: Choose the mode in which the gateways must operate.<br><br>The "test" mode means that you can submit test orders and perform test transaction. Money will not be withdrawn from credit cards. The "live" mode is the full functioning mode with real transactions and charges. It must be used when only you are ready to go live.
 #* <u>Action to be performed on order placement:</u> Choose whether CyberSource Hosted Order Page must capture money automatically (Auth and Capture) or only freeze the funds until you capture the authorized amount manually through the X-Cart Admin area (Auth only).
-#* <u>Order prefix</u>: Enter a prefix that will be automatically added to IDs of orders placed in your store and paid through CyberSource Hosted Order Page.<br><br>Having a prefix ensures that orders will have unique IDs and will never coincide with orders placed in another online store of yours that also uses CyberSource as a payment option.<br><br>The values of the next 4 fields are supposed to be retrieved automatically from the security script generated on the side of CyberSource. To generate a script, log in to your CyberSource account at https://ebc.cybersource.com/ and go to Tools & Settings -> Hosted Order Page -> Security -> Generate Security Script. There select a radio button PHP, which stands for the respective scripting language, click Submit, and follow the instructions on the screen. As a result, you must be able to download a file HOP.php onto your local computer. The file should then be uploaded through the X-Cart Admin area. The fields mean as follows:
+#* <u>Order prefix</u>: Enter a prefix that will be automatically added to IDs of orders placed in your store and paid through CyberSource Hosted Order Page.<br><br>Having a prefix ensures that orders will have unique IDs and will never coincide with orders placed in another online store of yours that also uses CyberSource as a payment option.<br><br>The values of the next 4 fields are supposed to be retrieved automatically from the security PHP script. The security script can be generated in the CyberSource back-office as follows:<br>- Log in to your CyberSource account at https://ebc.cybersource.com/<br>- Go to Tools & Settings -> Hosted Order Page -> Security -> Generate Security Script.<br>- Select a radio button PHP, which stands for the respective scripting language, click Submit, and follow the instructions on the screen.<br><br>As a result, you must be able to download a file HOP.php onto your local computer. The file should then be uploaded through the "Upload security script" form on the configuration page.<br><br>The fields mean as follows:
 #* <u>Merchant ID: T</u>he name of your merchant account with CyberSource.
 #* <u>Serial number:</u> A unique code assigned to the security script to ensure its integrity.
@@ Line 39: / Line 39: @@
 : [[Image:pg_cybersource_04.gif|640px]]
 ==Setting up CyberSource SOAP Toolkit API==
@@ Line 78: / Line 76: @@
 ) Download: Update to ECert Application
 [http://apps.cybersource.com/cgi-bin/pages/additional.cgi?kit=Update_to_ECert_Application http://apps.cybersource.com/cgi-bin/pages/additional.cgi?kit=Update_to_ECert_Application]
 [[Category:X-Cart user manual]]
 [[Category:X-Cart user manual]]
 [[Category:Payment gateways]]

← Older revision		Revision as of 08:36, 16 February 2011
Line 81:		Line 81:
	[[Category:X-Cart user manual]]		[[Category:X-Cart user manual]]
	[[Category:X-Cart user manual]]		[[Category:X-Cart user manual]]
		+	[[Category:Payment gateways]]

← Older revision		Revision as of 07:39, 12 April 2010
Line 1:		Line 1:
		+	{{Note1\|This article describes setting up CyberSource for X-Cart 4.3.0 and above. To find out how to set up CyberSource for previous versions (4.0.0 - 4.2.x), read [[X-Cart:Setting_Up_Cybersource_for_previous_versions_%284.0.x,_4.1.x,_4.2.x%29 \| this article]].}}
		+
	==Overview==		==Overview==