X-Payments:Customizing the interface (X-Payments 3)

X-Payments user manual

1. X-Payments:General information
   • How It Works
   • Key features
2. What's New
   • What's New in X-Payments 3.1
   • What's New in X-Payments 3.0
3. System requirements
   • System requirements for X-Payments 3
   • System requirements for X-Payments 2.2
4. Installation
   • Installing X-Payments
   • Setting up file permissions for X-Payments
   • Getting started with X-Payments
5. Two-factor user authentication
   • Two-factor authentication (X-Payments 3)
   • Managing PIN codes (X-Payments 2.2 and earlier)
6. Configuring X-Payments
   • General settings
   • Online stores
   • Payment configurations
   • Encryption keys
   • 3D-Secure settings
   • KOUNT Antifraud screening
   • NoFraud fraud prevention
   • Signifyd fraud protection and chargeback prevention
7. Managing users
8. Customizing the interface
   • Customizing the interface (X-Payments 3)
   • Customizing the interface (X-Payments 2.2 and earlier)
9. Managing payments
10. Unistalling X-Payments
11. Upgrading
12. Moving X-Payments from one host to another
13. Viewing X-Payments logs
14. FAQ
15. Troubleshooting
16. Glossary
17. Supported payment gateways
    • Payment gateways supported by X-Payments 3.1
    • Payment gateways supported by X-Payments 3.0
    • Payment gateways supported by X-Payments 2.2
18. Popular Payment Methods Configuration Instructions
    • PayPal Payments Pro (PayPal API), PayPal Payments Pro (Payflow API), Payflow Pro
    • PayPal REST API
    • First Data Payeezy Gateway (ex- Global Gateway e4)
    • CyberSource - SOAP toolkit API

Customizing the payment form templates

X-Payments 3.x provides an interface for the customization of its payment form. Unlinke X-Payments 2.x, where you had to use FTP to connect to X-Payments server and upload your customized templates, in X-Payments 3.x the appearance of the payment form can be changed via the section Payment templates (Settings -> Templates):

Here's what this section looks like in your X-Payments Admin back end:

At the top of the section, the template selector is provided that allows you to select the template you require:

After selecting a template from the drop-down list, you can preview the payment form based on this template on the left-hand side of the same page:

If you are going to use the payment form in iframe, it is a good idea to preview it with the Preview in iframe mode option enabled:

For the sake of example, let us create a custom template based on the template "Orange":

1. In the Payment templates section of your X-Payments back end (Settings -> Templates), select the template on which you would like to base your work (in our case - "Orange"):
   
   
   (Note how the payment form preview on the left-hand side of the page changes after a new template has been selected).
2. Create a copy of the template "Orange". To do so, click the button Save copy as... below the payment form preview area:
   
   
   A popup form appears on the screen allowing you to enter a name for your template copy:
   
   
   Simply replace the name of the original template with a new one (Below you can see how we changed the name "Orange" to "test") and click Save:
   
   
   The template copy will be created:
   
   
   Now you can safely play with the settings on the template copy without running the risk of spoiling the original template (in our case, "Orange"). If you do not like the result, you will be able to discard the template copy and start anew at any time.
3. The settings below the template selector allow you to adjust the various aspects of the payment form appearance. Click the tabs (General styles, Logo and header, Payment info, Card details and Buttons) to access the settings you require.
   
   
   To change the template, try changing the original styles to the ones you require. Your changes will be shown on the preview in real time:
   
   
   
4. Click Save to save the changes:
   
   
   Now you have a new template which you can select when configuring your online stores.
5. If necessary, you can delete the template or save its copy under a new name:
   
   
   

Translating the User Interface / Editing Text Labels

To change the wording of certain phrases in the X-Payments Admin back end or on the payment form where your customers enter their credit card information, or to translate the X-Payments user interface to another language, use the section Language translations (Settings -> Languages):

Here's what this section looks like in your X-Payments Admin back end: