X-Cart:Braintree Integration - Revision history

Mouse at 13:49, 22 July 2020

2020-07-22T13:49:08Z

Dohtur at 12:02, 11 May 2017

2017-05-11T12:02:37Z

Dohtur: /* Enabling the Braintree Payments payment method in X-Cart */

2017-05-11T12:01:16Z

‎Enabling the Braintree Payments payment method in X-Cart

Dohtur: /* Checkout page */

2015-12-15T18:14:42Z

‎Checkout page

Dohtur: /* Checkout page */

2015-12-15T18:12:23Z

‎Checkout page

Dohtur at 18:03, 15 December 2015

2015-12-15T18:03:01Z

Dohtur: /* Enabling the Braintree Payments payment method in X-Cart */

2015-12-15T17:58:43Z

‎Enabling the Braintree Payments payment method in X-Cart

Dohtur: /* Enabling the Braintree Payments payment method in X-Cart */

2015-12-15T17:46:38Z

‎Enabling the Braintree Payments payment method in X-Cart

Dohtur: /* Installation */

2015-12-15T17:33:39Z

‎Installation

Dohtur at 14:47, 15 December 2015

2015-12-15T14:47:28Z

@@ Line 15: / Line 15: @@
 <br /><br />
-The <u>Braintree payment integration</u> module can be [http://www.x-cart.com/extensions/modules/braintree-payment-integration.html purchased] and installed on all X-Cart editions.
+The <u>Braintree payment integration</u> module can be [https://www.x-cart.com/extensions/modules/braintree-payment-integration.html purchased] and installed on all X-Cart editions.
 == System requirements ==

@@ Line 67: / Line 67: @@
 #* Scroll down to the bottom of the list of your store's payment methods and find the "Braintree Payments" item in it; click the '''Configure''' button next to it.<br />[[File:xc4_braintree_pm_add2.png|border]]<br />The Braintree Payments settings page opens:<br />[[File:xc4_braintree_settings.png|border]]<br /><br />
 # On the settings page, adjust the payment method details:
-#* '''Merchant ID''', '''Public key''' and '''Private key''': Specify your credentials for access to the Braintree API. See [https://articles.braintreepayments.com/control-panel/important-gateway-credentials] for more info.
+#* '''Merchant ID''', '''Public key''' and '''Private key''': Specify your credentials for access to the Braintree API. See [https://articles.braintreepayments.com/control-panel/important-gateway-credentials Important Gateway Credentials] for more info.
 #* '''Use vault''': Specify whether you want to enable storage of credit cards in the Braintree Vault.
 #* '''Kount merchant ID''': (This setting should be adjusted only if you use Kount) Your Kount merchant ID.

@@ Line 67: / Line 67: @@
 #* Scroll down to the bottom of the list of your store's payment methods and find the "Braintree Payments" item in it; click the '''Configure''' button next to it.<br />[[File:xc4_braintree_pm_add2.png|border]]<br />The Braintree Payments settings page opens:<br />[[File:xc4_braintree_settings.png|border]]<br /><br />
 # On the settings page, adjust the payment method details:
-#* '''Merchant ID''', '''Public key''' and '''Private key''': Specify your credentials for access to the Braintree API.
+#* '''Merchant ID''', '''Public key''' and '''Private key''': Specify your credentials for access to the Braintree API. See [https://articles.braintreepayments.com/control-panel/important-gateway-credentials] for more info.
 #* '''Use vault''': Specify whether you want to enable storage of credit cards in the Braintree Vault.
 #* '''Kount merchant ID''': (This setting should be adjusted only if you use Kount) Your Kount merchant ID.

@@ Line 79: / Line 79: @@
 ==Checkout page==
-Once the configuration is complete, the form to enter credit card details will be displayed right on the checkout page of your store:
+Once the configuration is complete, the form to enter credit card details will be displayed right on the checkout page of your store:<br />
+[[File:xc4_braintree_checkout_s.png|border]]
 <br /><br />
 [[Category:X-Cart modules]]

@@ Line 83: / Line 83: @@
 <br /><br />
-[[Image:Braintree-checkout.png|border]]
+[[File:xc4_braintree_checkout_s.png|border]]
 [[Category:X-Cart modules]]

@@ Line 75: / Line 75: @@
 # Click '''Update''' to apply the changes.<br /><br />
 # The first time you submit your settings, the module will attempt to verify the account settings you provided. You should expect to see a warning on a yellow background:<br />[[File:xc4_braintree_settings_yellow.png|border]]<br />This type of warning shows that the submitted account information has not yet been verified. If you see this warning, click the '''Check account''' button. The module will request verification of the submitted information from Braintree. If the information is incorrect, you will see the following warning on a red background:<br />[[File:xc4_braintree_settings_red.png|border]]<br />If the information is correct and can be used to access the Braintree API, you should see a success message on a green background:<br />[[File:xc4_braintree_settings_green.png|border]]<br /><br />
-# Activate the payment method "Braintree Payments" on the Payment methods page: select the check box at the left of the method name and click '''Apply changes'''. The method will be activated:<br />[[File:xc4_braintree_activated.png|border]]<br />
+# Activate the payment method "Braintree Payments" on the Payment methods page: select the check box at the left of the method name and click '''Apply changes'''.<br />[[File:xc4_braintree_activate.png|border]]<br />The method will be activated:<br />[[File:xc4_braintree_activated.png|border]]<br /><br />
 ==Checkout page==

@@ Line 61: / Line 61: @@
 Once you have installed the Braintree payments module, enable it in the X-Cart Admin area:
-# Go to the Payment methods section ('''Settings -> Payment methods''').
+# Go to the Payment methods section ('''Settings -> Payment methods''').<br />
-# On the Payment gateways tab, select "Braintree Payments" from the list and click '''Add'' to add it to the list:<br />[[File:xc4_braintree_pm_add.png|border]]<br />The payment method "Braintree Payments" will be added:<br />[[File:xc4_braintree_pm_add1.png|border]]<br />
+# On the '''Payment gateways''' tab, select "Braintree Payments" from the Payment gateways list and click '''Add''' to add it to your store's list of payment methods:<br />[[File:xc4_braintree_pm_add.png|border]]<br />The payment method "Braintree Payments" will be added:<br />[[File:xc4_braintree_pm_add1.png|border]]<br /><br />
 # Go to the Braintree Payments settings page:
 #* Click the name of the payment method "Braintree Payments" in the list of recently added payment methods.<br />or
-#* Scroll down to the bottom of the list of your store's payment methods and find the "Braintree Payments" item in it; click the '''Configure''' button next to it.<br />[[File:xc4_braintree_pm_add2.png|border]]<br />The Braintree Payments settings page opens:<br />[[File:xc4_braintree_settings.png|border]]<br />
+#* Scroll down to the bottom of the list of your store's payment methods and find the "Braintree Payments" item in it; click the '''Configure''' button next to it.<br />[[File:xc4_braintree_pm_add2.png|border]]<br />The Braintree Payments settings page opens:<br />[[File:xc4_braintree_settings.png|border]]<br /><br />
 # On the settings page, adjust the payment method details:
 #* '''Merchant ID''', '''Public key''' and '''Private key''': Specify your credentials for access to the Braintree API.
@@ Line 72: / Line 72: @@
 #* '''Automatically settle the transaction''': Specify the mode in which transactions should be conducted via Braintree payments. "Off" = authorization to capture the funds should be obtained (The funds will need to be captured manually at a later time). "On" = the funds should be authorized and captured at once.
 #* '''Test/Live mode''': Specify your store's payment mode. For testing purposes, set this value to "Test". For production, set to "Live". Note that the set of API access credentials for Test and Live modes should be different, so be sure to adjust the values in the "Merchant ID", "Public key" and "Private key" fields according to the mode selected.
-#* '''Order prefix''': Set a prefix that will allow Braintree to identify orders as originating from this store. For example, this may be useful if your Braintree account is used for more than one stores.
+#* '''Order prefix''': Set a prefix that will allow Braintree to identify orders as originating from this store. For example, this may be useful if your Braintree account is used for more than one stores.<br /><br />
-# Click '''Update''' to apply the changes.
+# Click '''Update''' to apply the changes.<br /><br />
 # The first time you submit your settings, the module will attempt to verify the account settings you provided. You should expect to see a warning on a yellow background:<br />[[File:xc4_braintree_settings_yellow.png|border]]<br />This type of warning shows that the submitted account information has not yet been verified. If you see this warning, click the '''Check account''' button. The module will request verification of the submitted information from Braintree. If the information is incorrect, you will see the following warning on a red background:<br />[[File:xc4_braintree_settings_red.png|border]]<br />If the information is correct and can be used to access the Braintree API, you should see a success message on a green background:<br />[[File:xc4_braintree_settings_green.png|border]]<br /><br />
 ==Checkout page==

@@ Line 47: / Line 47: @@
 <pre>tar -xzvf braintree.4.x.x.tgz</pre>
-{{Note1|Important: Make sure that you maintain the directory structure while unpacking and uploading the distribution package; otherwise, some critical files can be overwritten! }}
+{{Note1|Important: Make sure that you maintain the directory structure while unpacking and uploading the distribution package; otherwise, some critical files may be overwritten! }}
 ==Enabling the Braintree Payments payment method in X-Cart==