Difference between revisions of "XP Cloud:General Settings"

From X-Payments Help
Jump to: navigation, search
m (Mouse moved page X-Payments Cloud:General Settings to XP Cloud:General Settings: Test page move from API)
m
 
(9 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
__NOTOC__<br>
 
__NOTOC__<br>
  
X-Payments Cloud general settings can be found on the General settings page ('''Settings''' -> '''General settings'''). This page is available from both the X-Payments Cloud standalone admin panel:
+
X-Payments Cloud general settings can be found on the General settings page ('''Settings''' -> '''General'''). This page is available from both the X-Payments Cloud standalone admin panel:
: [[File:xpc_general_settings_link_s.png | 740px | border]]<br />
+
: [[File:xpc_general_settings_link_s.png | 670px | border]]<br />
 
and the X-Payments Cloud admin panel as accessed from within the admin panel of your online store:
 
and the X-Payments Cloud admin panel as accessed from within the admin panel of your online store:
: [[File:xpc_general_settings_link.png | 740px | border]]<br />
+
: [[File:xpc_general_settings_link.png | 670px | border]]<br />(The screenshot above shows the way to access the General settings page from the X-Cart 5 admin panel. On other platforms, you will find a similar menu, but please expect that the page layout may be different.)
The page itself looks as follows:
+
The General settings page itself looks as follows:
: [[File:xpc_general_settings.png | 740px | border]]<br />
+
: [[File:xpc2021_general_settings.png | 670px | border]]<br /><br />
Before you start using X-Payments Cloud to accept payments, take time to review the settings on this page and adjust them as you require. Be sure to click the '''Save''' button at the bottom of the page to save your changes.
+
Before you start using X-Payments Cloud to accept payments, take time to review the settings on this page, and adjust them as you require. Be sure to click the '''Save''' button at the bottom of the page to save your changes.
  
 
Below you will find an explanation of what each setting is used for.
 
Below you will find an explanation of what each setting is used for.
Line 15: Line 15:
 
===Configuration===
 
===Configuration===
 
In this section, the only setting is '''Current time and date'''.
 
In this section, the only setting is '''Current time and date'''.
: [[File:xpc_general_settings_configuration.png| 740px | border]]
+
: [[File:xpc_general_settings_configuration.png| 670px | border]]
  
 
Use it to specify the current time and date in your time zone. That is needed so X-Payments Cloud can record the time and date of payments correctly.
 
Use it to specify the current time and date in your time zone. That is needed so X-Payments Cloud can record the time and date of payments correctly.
  
===API Keys===
+
===Connection Key===
 
   
 
   
This section is only available in the X-Payments Cloud standalone admin panel (not visible when the settings page is accessed from within the admin panel of your online store). It shows the date when the current keys were generated. It also provides the '''Manage API keys''' link for access to the API Keys page in the X-Payments Cloud admin panel.  
+
This section is only available in the X-Payments Cloud standalone admin panel (not visible when the settings page is accessed from within the admin panel of your online store). It shows the date on which the current connection key was generated. It also provides the '''View connection key''' link for access to the Connection Key page in the X-Payments Cloud admin panel.  
  
:[[File:xpc_general_settings_apikeys.png | 740px | border]]
+
:[[File:xpc_connection_key_section.png | 670px | border]]
  
On the API Keys page, you can view your current API keys:
+
On the Connection Key page, you can preview and copy your current connection key.
* API key (the key used to make calls),  
+
:[[File:xpc_connection_key_page.png | 670px | border]]
* Secret key (the key used to validate API calls),
+
 
* Widget key (the key used to show the payment widget).
+
A connection key is a bundle that contains the following components:
 +
* API key (the key used to make API requests),  
 +
* Secret key (the key used to validate API requests),
 +
* Widget key (the key used to display the payment form widget in the process of checkout).
  
The page also provides the '''Re-generate keys''' button that allows you to re-generate your keys.
 
 
:[[File:xpc_api_keys.png | 740px | border]]
 
  
 
===Services===
 
===Services===
  
This section is where you can configure and enable 3D-secure and fraud prevention services.
+
This section is where you can configure and enable [[XP_Cloud:Services | services]].
: [[File:xpc_general_settings_service.png | 740 px | border]]
+
: [[File:xpc_services_section.png | 670 px | border]]
 +
 
 +
===Processing===
 +
 
 +
:[[File:xpc_general_settings_processing.png | 670 px | border]]
 +
 
 +
This section contains the following settings:
 +
 
 +
:* '''Transaction amount for card tokenization''': An amount for which a transaction needs to be created during a card tokenization process for gateways that do not support "zero-dollar" authorizations. This transaction will be voided automatically.
 +
 
 +
:* '''Detect Cloudflare client IP address''': A proxy related setting. The idea behind this setting is that if your store server uses Cloudflare, it may interfere with the work of X-Payments Cloud. You may want to enable this setting to resolve the IP address-related issues that may arise if using Cloudflare.
 +
 
 +
===Subscriptions===
 +
 
 +
:[[File:xpc_general_settings_subscriptions.png | 670 px | border]]
  
===Miscellaneous===
+
This section contains the following settings:
  
 +
:* '''Number of rebill attempts for an unsuccessful charge''': The maximum number of times that X-Payments must try to charge the customer's card after the initial attempt to process the subscription payment was unsuccessful. After this number of additional attempts, X-Payments will stop the subscription and send an email notification message to the X-Payments administrator.
  
:[[File:xpc_general_settings_misc.png | 740 px | border]]
+
:* '''How often to attempt rebills for an unsuccessful charge (in days)''': How often X-Payments must attempt to charge the card again if the initial attempt to process the subscription payment was unsuccessful. For example, if you set this value to "3", X-Payments will attempt to charge the customer's card once every three days - until the payment can be processed successfully, or the maximum number of rebill attempts is reached.
  
This section contains a proxy related setting, '''Detect Cloudflare client IP address'''. The idea behind this setting is that if your store server uses Cloudflare, it may interfere with the work of X-Payments Cloud. You may want to enable this setting to resolve the IP address related issues that may arise if using Cloudflare.
+
:* '''Notify the customer of the upcoming payment X days in advance''': X-Payments can notify subscription customers that they are going to be charged for their subscription soon - a few days before the subscription payment is actually billed to their account. This setting allows you to specify how many days in advance X-Payments must send a notification message about the upcoming subscription payment to customers with active subscriptions.
  
 
[[Category:X-Payments Cloud User Manual]]
 
[[Category:X-Payments Cloud User Manual]]

Latest revision as of 04:07, 1 October 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


X-Payments Cloud general settings can be found on the General settings page (Settings -> General). This page is available from both the X-Payments Cloud standalone admin panel:

Xpc general settings link s.png

and the X-Payments Cloud admin panel as accessed from within the admin panel of your online store:

Xpc general settings link.png
(The screenshot above shows the way to access the General settings page from the X-Cart 5 admin panel. On other platforms, you will find a similar menu, but please expect that the page layout may be different.)

The General settings page itself looks as follows:

Xpc2021 general settings.png

Before you start using X-Payments Cloud to accept payments, take time to review the settings on this page, and adjust them as you require. Be sure to click the Save button at the bottom of the page to save your changes.

Below you will find an explanation of what each setting is used for.

Configuration

In this section, the only setting is Current time and date.

Xpc general settings configuration.png

Use it to specify the current time and date in your time zone. That is needed so X-Payments Cloud can record the time and date of payments correctly.

Connection Key

This section is only available in the X-Payments Cloud standalone admin panel (not visible when the settings page is accessed from within the admin panel of your online store). It shows the date on which the current connection key was generated. It also provides the View connection key link for access to the Connection Key page in the X-Payments Cloud admin panel.

Xpc connection key section.png

On the Connection Key page, you can preview and copy your current connection key.

Xpc connection key page.png

A connection key is a bundle that contains the following components:

  • API key (the key used to make API requests),
  • Secret key (the key used to validate API requests),
  • Widget key (the key used to display the payment form widget in the process of checkout).


Services

This section is where you can configure and enable services.

Xpc services section.png

Processing

Xpc general settings processing.png

This section contains the following settings:

  • Transaction amount for card tokenization: An amount for which a transaction needs to be created during a card tokenization process for gateways that do not support "zero-dollar" authorizations. This transaction will be voided automatically.
  • Detect Cloudflare client IP address: A proxy related setting. The idea behind this setting is that if your store server uses Cloudflare, it may interfere with the work of X-Payments Cloud. You may want to enable this setting to resolve the IP address-related issues that may arise if using Cloudflare.

Subscriptions

Xpc general settings subscriptions.png

This section contains the following settings:

  • Number of rebill attempts for an unsuccessful charge: The maximum number of times that X-Payments must try to charge the customer's card after the initial attempt to process the subscription payment was unsuccessful. After this number of additional attempts, X-Payments will stop the subscription and send an email notification message to the X-Payments administrator.
  • How often to attempt rebills for an unsuccessful charge (in days): How often X-Payments must attempt to charge the card again if the initial attempt to process the subscription payment was unsuccessful. For example, if you set this value to "3", X-Payments will attempt to charge the customer's card once every three days - until the payment can be processed successfully, or the maximum number of rebill attempts is reached.
  • Notify the customer of the upcoming payment X days in advance: X-Payments can notify subscription customers that they are going to be charged for their subscription soon - a few days before the subscription payment is actually billed to their account. This setting allows you to specify how many days in advance X-Payments must send a notification message about the upcoming subscription payment to customers with active subscriptions.