Difference between revisions of "XP Cloud:Adding a Payment Configuration"

From X-Payments Help
Jump to: navigation, search
m
 
(8 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
New payment configurations can be added via the Payment processing page ('''Settings''' -> '''Payment processing'''). <br />
 
New payment configurations can be added via the Payment processing page ('''Settings''' -> '''Payment processing'''). <br />
 
In X-Payments Cloud trial, you will find that this page already has one pre-added payment configuration: X-Payments Demo Pay.  
 
In X-Payments Cloud trial, you will find that this page already has one pre-added payment configuration: X-Payments Demo Pay.  
:[[File:xpc_demo_pay_conf.png| 740px | border]]
+
:[[File:xpc_demo_pay_conf.png| 670px | border]]
 
The X-Payments Demo Pay payment configuration is purely for testing. You can play with its settings and run some test transactions using the respective payment method in your online store to see how payments via X-Payments Cloud work for your store without having to use your real payment card information. Just be sure to use the demo credit card numbers provided on the payment configuration details page:
 
The X-Payments Demo Pay payment configuration is purely for testing. You can play with its settings and run some test transactions using the respective payment method in your online store to see how payments via X-Payments Cloud work for your store without having to use your real payment card information. Just be sure to use the demo credit card numbers provided on the payment configuration details page:
:[[File:xpc_demo_pay_conf_numbers.png|740px| border]]<br /><br />
+
:[[File:xpc_demo_pay_conf_numbers.png|670px| border]]<br /><br />
 
To be able to accept real payments, you will need to add a new payment configuration enabling X-Payments Cloud to connect to your chosen payment processor. You can find out whether X-Payments Cloud is integrated with your chosen payment processor here: [[X-Payments_Cloud:Supported_payment_gateways | X-Payments Cloud:Supported Payment Gateways]]. Note that as soon as your first payment configuration is added and activated, the X-Payments Demo Pay payment configuration will be disabled automatically. (Should you require to use it again, you can re-enable it by deactivating all your other active payment configurations.)
 
To be able to accept real payments, you will need to add a new payment configuration enabling X-Payments Cloud to connect to your chosen payment processor. You can find out whether X-Payments Cloud is integrated with your chosen payment processor here: [[X-Payments_Cloud:Supported_payment_gateways | X-Payments Cloud:Supported Payment Gateways]]. Note that as soon as your first payment configuration is added and activated, the X-Payments Demo Pay payment configuration will be disabled automatically. (Should you require to use it again, you can re-enable it by deactivating all your other active payment configurations.)
  
 
To add a new payment configuration, select the name of the payment gateway integration you require from the '''New configuration''' drop-down box and click '''Add'''.
 
To add a new payment configuration, select the name of the payment gateway integration you require from the '''New configuration''' drop-down box and click '''Add'''.
:[[File:xpc_add_payment_configuration.png| 740px | border]]
+
:[[File:xpc_add_payment_configuration.png| 670px | border]]
  
For the sake of example, we will add a payment configuration to accept payments in United States dollar (USD) via Authorize.Net.
+
For the sake of example, we will add a payment configuration to accept payments in the United States dollar (USD) via Authorize.Net.
  
 
We start by selecting the payment gateway integration "Authorize.Net":
 
We start by selecting the payment gateway integration "Authorize.Net":
:[[File:xpc_add_authorize.png| 740px | border]]
+
:[[File:xpc_add_authorize.png| 670px | border]]
  
 
Once we click '''Add''', the 'Add new payment configuration' page for Authorize.Net opens:
 
Once we click '''Add''', the 'Add new payment configuration' page for Authorize.Net opens:
:[[File:xpc_add_authorize1.png|740 px|border]]
+
:[[File:xpc_authorize_payment_configuration.jpg|670 px|border]]
  
 
Here we need to provide the information needed by X-Payments Cloud to access the payment gateway and to specify our payment configuration preferences.  
 
Here we need to provide the information needed by X-Payments Cloud to access the payment gateway and to specify our payment configuration preferences.  
Line 32: Line 32:
 
* '''Order prefix''': Your trading name or any other prefix that will help you to identify a payment transaction as originating from this specific online store.
 
* '''Order prefix''': Your trading name or any other prefix that will help you to identify a payment transaction as originating from this specific online store.
 
* '''Accept currencies''': The currencies in which you will be able to accept payments via the payment method based on this payment configuration. By default, this setting is pre-set to ''All supported (N)'', which means all the currencies supported by the payment gateway - with the number N specifying the number of currencies. To limit the range of currencies that will be accepted, click on the ''All supported (N)'' button, uncheck the ''Select all'' box - this will unselect all the selected currencies - and check the boxes for the currencies that you will accept. For the sake of example, we are creating a configuration that will support only United States dollar; so here we need to disable all the currencies but USD:  
 
* '''Accept currencies''': The currencies in which you will be able to accept payments via the payment method based on this payment configuration. By default, this setting is pre-set to ''All supported (N)'', which means all the currencies supported by the payment gateway - with the number N specifying the number of currencies. To limit the range of currencies that will be accepted, click on the ''All supported (N)'' button, uncheck the ''Select all'' box - this will unselect all the selected currencies - and check the boxes for the currencies that you will accept. For the sake of example, we are creating a configuration that will support only United States dollar; so here we need to disable all the currencies but USD:  
:[[File:xpc_add_authorize_currencies.png|740 px|border]]
+
:[[File:xpc_add_authorize_currencies.png|670 px|border]]
* '''Credit card types''': The credit card types you are going to accept.
+
* '''Credit card types''': The credit card types you wish to accept via the payment method based on this payment configuration.
 +
* '''Order total limits''' (Minimum / Maximum): The transaction amount range that you wish to accept via the payment method based on this payment configuration.
 
* '''Cancel not captured''': Whether authorizations obtained for payments made in the "Auth" mode should be voided automatically within 30 days of payment if the capture of the funds has not been performed.
 
* '''Cancel not captured''': Whether authorizations obtained for payments made in the "Auth" mode should be voided automatically within 30 days of payment if the capture of the funds has not been performed.
  
 
After adjusting the payment configuration settings as you require, be sure to click '''Save''' to save your changes.  
 
After adjusting the payment configuration settings as you require, be sure to click '''Save''' to save your changes.  
:[[File:xpc_add_authorize_save.png|740 px|border]]
+
:[[File:xpc_add_authorize_save.png|670 px|border]]
  
 
The payment configuration will be saved and enabled:
 
The payment configuration will be saved and enabled:
:[[File:xpc_add_authorize_success.png|740 px|border]]
+
:[[File:xpc_add_authorize_success.png|670 px|border]]
 
(Note the success message at the top of the page and the green status button saying "Enabled".)
 
(Note the success message at the top of the page and the green status button saying "Enabled".)
  
Once the payment configuration has been saved and enabled, scroll down the page, and you will find one more thing added to your payment configuration details - the status of your 3-D Secure service (Enabled/Disabled):
+
Once the payment configuration has been saved and enabled, review the payment configuration detail page. At the bottom of this page, you will find a few more settings added; those are related to the use of services with this payment configuration (which services should be enabled):
:[[File:xpc_payment_configuration_3dsecure_enabled.png|740 px|border]]
+
:* 3-D Secure;
This setting determines whether the current payment configuration will be using the CardinalCommerce 3-D Secure service.
+
:* Apple Pay;
If you have configured and enabled CardinalCommerce 3-D Secure service while configuring your X-Payments Cloud General settings, you will find that the status of 3-D Secure service shows as ''Enabled'' for your payment configuration; in this case, nothing else needs to be done: 3-D Secure will work automatically for all your active payment configurations, including this one. If you have not yet configured and enabled CardinalCommerce 3-D Secure, you can do it now or any time later: simply click on the ''CardinalCommerce'' link to get to the page with CardinalCommerce 3-D Secure configuration details, adjust the required fields and update the 3-D Secure status to ''Enabled''.  <br />
+
:* Google Pay.
 +
:[[File:xpc_payment_configuration_3dsecure_enabled.png|670 px|border]]
  
Of course, if you do not want the current payment configuration to use the 3-D Secure service by CardinalCommerce, you can disable it by switching the status to ''Disabled''.
+
Note that Apple Pay and Google Pay are available only on advanced X-Payments plans (100K+ transactions per year).
 +
 
 +
Before enabling any of the settings, please make sure that they are enabled for your Authorize.Net account.
 +
 
 +
Instructions for configuring the services can be found here:
 +
:* [[XP_Cloud:3D-Secure | 3-D Secure]];
 +
:* [[XP_Cloud:Apple_Pay | Apple Pay]];
 +
:* [[XP_Cloud:Google_Pay | Google Pay]].
  
 
After completing work on your payment configuration, you can go back to the Payment processing page ('''Settings''' -> '''Payment processing''') to view the list of your payment configurations.
 
After completing work on your payment configuration, you can go back to the Payment processing page ('''Settings''' -> '''Payment processing''') to view the list of your payment configurations.
:[[File:xpc_back2payment_configurations_list.png|740px|border]]  
+
:[[File:xpc_back2payment_configurations_list.png|670px|border]]  
 +
 
 +
Here you will be able to add more payment configurations if required. For more information on the management of payment configurations, see [[X-Payments_Cloud:Payment_Configurations_List | Payment Configurations List]].
  
Here you will be able to add more payment configurations if required. For more information on the management of payment configurations, see [[X-Payments_Cloud:Payment_Configurations_List | Payment_Configurations_List]].
+
We have instructions for configuring some other popular payment methods:
 +
* [[XP_Cloud:PayPal_Payment_Pro_(Payflow_API) | PayPal Payment Pro (Payflow API)]]
 +
* [[XP_Cloud:PayPal_Payment_Pro_(PayPal_API) | PayPal Payment Pro (PayPal API)]]
 +
* [[XP_Cloud:Payflow_Pro| Payflow Pro ]]
 +
* [[X-Payments:FirstData | First Data Payeezy Gateway (formerly known as Global Gateway e4)]]
 +
* [[XP_Cloud:CyberSource_-_SOAP_toolkit_API | CyberSource - SOAP toolkit API]]
 +
* [[XP_Cloud:Intuit QuickBooks Payments | Intuit QuickBooks Payments ]]
  
 
[[Category:X-Payments Cloud User Manual]]
 
[[Category:X-Payments Cloud User Manual]]

Latest revision as of 22:59, 27 September 2021

X-Payments Cloud User Manual
  1. X-Payments Cloud: General information
  2. Get Started with X-Payments Cloud
  3. Two-factor User Authentication
  4. General Settings
  5. Payment Configurations
  6. Services
  7. Users
  8. User Interface
  9. Payments
  10. Supported Payment Gateways
  11. What's New in X-Payments Cloud


New payment configurations can be added via the Payment processing page (Settings -> Payment processing).
In X-Payments Cloud trial, you will find that this page already has one pre-added payment configuration: X-Payments Demo Pay.

Xpc demo pay conf.png

The X-Payments Demo Pay payment configuration is purely for testing. You can play with its settings and run some test transactions using the respective payment method in your online store to see how payments via X-Payments Cloud work for your store without having to use your real payment card information. Just be sure to use the demo credit card numbers provided on the payment configuration details page:

Xpc demo pay conf numbers.png

To be able to accept real payments, you will need to add a new payment configuration enabling X-Payments Cloud to connect to your chosen payment processor. You can find out whether X-Payments Cloud is integrated with your chosen payment processor here: X-Payments Cloud:Supported Payment Gateways. Note that as soon as your first payment configuration is added and activated, the X-Payments Demo Pay payment configuration will be disabled automatically. (Should you require to use it again, you can re-enable it by deactivating all your other active payment configurations.)

To add a new payment configuration, select the name of the payment gateway integration you require from the New configuration drop-down box and click Add.

Xpc add payment configuration.png

For the sake of example, we will add a payment configuration to accept payments in the United States dollar (USD) via Authorize.Net.

We start by selecting the payment gateway integration "Authorize.Net":

Xpc add authorize.png

Once we click Add, the 'Add new payment configuration' page for Authorize.Net opens:

Xpc authorize payment configuration.jpg

Here we need to provide the information needed by X-Payments Cloud to access the payment gateway and to specify our payment configuration preferences.

Note that the information we are expected to provide will be different depending on the payment gateway selected. For example, specifically for Authorize.Net, the following details will be needed:

  • API Login ID and Transaction key - These values will have to be obtained from Authorize.Net.
  • CIM payment tokenization and Expanded Credit Capabilities - These values will have to be set in accordance with our Authorize.Net account settings.

The rest of the fields on the page will be common to most configurations:

  • Name: Name to identify the payment configuration in X-Payments Cloud admin panel and the admin panel of your online store. You can keep the proposed name or choose to change it. For example, if you are going to have more than one payment configurations based on the same payment module - like when you want to use more than one currency - it is best to change the name so you can see which payment configuration you are dealing with without having to open its details. For example, we can change the name to "Authorize.Net - USD" to reflect the name of the currency that is going to be used for payments via this configuration.
  • Sandbox/Production account or Test/Live mode: Whether you are using a development/sandbox environment or a production environment. A production environment is used for real payments (Live mode), whereas a development/sandbox environment is used for testing (Test mode).
  • Initial transaction: The mode in which you want the payment transaction to be conducted when someone buys something at your online store: Auth (authorize the payment amount but not capture the funds yet) or Auth and capture (authorize and capture the payment amount at once).
  • Order prefix: Your trading name or any other prefix that will help you to identify a payment transaction as originating from this specific online store.
  • Accept currencies: The currencies in which you will be able to accept payments via the payment method based on this payment configuration. By default, this setting is pre-set to All supported (N), which means all the currencies supported by the payment gateway - with the number N specifying the number of currencies. To limit the range of currencies that will be accepted, click on the All supported (N) button, uncheck the Select all box - this will unselect all the selected currencies - and check the boxes for the currencies that you will accept. For the sake of example, we are creating a configuration that will support only United States dollar; so here we need to disable all the currencies but USD:
Xpc add authorize currencies.png
  • Credit card types: The credit card types you wish to accept via the payment method based on this payment configuration.
  • Order total limits (Minimum / Maximum): The transaction amount range that you wish to accept via the payment method based on this payment configuration.
  • Cancel not captured: Whether authorizations obtained for payments made in the "Auth" mode should be voided automatically within 30 days of payment if the capture of the funds has not been performed.

After adjusting the payment configuration settings as you require, be sure to click Save to save your changes.

Xpc add authorize save.png

The payment configuration will be saved and enabled:

Xpc add authorize success.png

(Note the success message at the top of the page and the green status button saying "Enabled".)

Once the payment configuration has been saved and enabled, review the payment configuration detail page. At the bottom of this page, you will find a few more settings added; those are related to the use of services with this payment configuration (which services should be enabled):

  • 3-D Secure;
  • Apple Pay;
  • Google Pay.
Xpc payment configuration 3dsecure enabled.png

Note that Apple Pay and Google Pay are available only on advanced X-Payments plans (100K+ transactions per year).

Before enabling any of the settings, please make sure that they are enabled for your Authorize.Net account.

Instructions for configuring the services can be found here:

After completing work on your payment configuration, you can go back to the Payment processing page (Settings -> Payment processing) to view the list of your payment configurations.

Xpc back2payment configurations list.png

Here you will be able to add more payment configurations if required. For more information on the management of payment configurations, see Payment Configurations List.

We have instructions for configuring some other popular payment methods: