X-Payments:Using X-Payments with Zoey

Video tutorial

This video shows how to connect X-Payments with Zoey store to enable PA-DSS compliant credit card processing and storing. Also, you'll see how X-Payments credit card form looks during checkout and how to change the form background and font colors to match your store design.

More information on X-Payments is available at http://www.x-payments.com/

Published on Oct 12, 2016

Important: Further contents of this section is currently a draft. The material may not yet be complete, information may be omitted, and certain parts of the content may be subject to radical, rapid alteration.

After configuring the connection to your Zoey store in X-Payments, log in to your Zoey Control panel and complete setting up the connection.

The following procedure assumes that:

• You are using a Zoey connector version XXX or later.
• Your Zoey store has the X-Payments connector extension installed.

Complete the following steps:

1. Log in to the Control panel of your Zoey store.
2. Go to Set-up -> Payment:
   
   
   
3. Locate the X-Payments payment method and choose to configure it by clicking the Configure button.
   
   
   The page showing how to connect X-Payments with Zoey in three easy steps opens:
   
   
   
4. Click the "Configure X-Payments connector" button:
   
   
   This opens the Connection settings section:
   
   
   
5. In the details of your Zoey online store in the X-Payments back end, copy your X-Payments configuration bundle and paste it into the respective box in your Zoey Control panel.
   If you are using X-Payments in Developer mode and need to enable communication between X-Payments and your Zoey store via HTTP, enable the Use HTTP protocol option.
   
   
6. Click Deploy.
   
   
   In a couple of seconds, the configuration bundle will be deployed. You should see a page like the following:
   
   
   
7. Check the list of payment methods that have been imported from X-Payments. On the screenshot below you can see that a single payment method has been imported - "Authorize.Net":
   
   
   If you need to add more payment methods that will work for your Zoey store via X-Payments, you will have to add them in X-Payments and use the Re-import payment methods button in the Zoey store to import them.
   
   
   To quickly access the X-Payments page where you can add more payment methods, use the "Add payment method" link.
   
   It is possible to add up to three payment methods.
   
   
8. If you look at the details of the payment method "Authorize.Net" we have imported from X-Payments, you will see that it is set to work using the currency "USD".
   
   
   The currency is set in X-Payments, and should you want to change the currency used, you will want to do that via the payment configuration settings on the X-Payments end, after which you will have to re-import the payment method settings into your Zoey store with the Re-import payment methods button.
   
   
9. Also note the "Save card" checkbox for the imported Authorize.Net payment method.
   
   
   The presence of this checkbox means that the method allows the use of saved credit cards. If you want to allow your customers to save credit cards for future use at your store using this payment method, keep the checkbox enabled. In this case, registered customers will be provided with an option to save their credit card details for future orders - either during checkout or at any other time via the XXX "MY PAYMENT CARDS" section of their account.
   
   Note: The credit card details will be saved in a PCI compliant manner (by your payment service provider, not by your Zoey store itself). After having their credit card details saved, customers will be able to use their saved credit cards for new orders. You - as the store administrator - will also be able to use your customers' saved credit cards to create XXX orders for your customers via the Zoey store Control panel.
   
   If you do not want to allow the use of saved credit cards using this method, unselect the checkbox. In this case, your customers will not be able to save their cards or use them for payment.
   
   
10. After the deployment of the configuration bundle, the payment methods imported from X-Payments are not active for your Zoey store yet. (Note the unchecked checkbox in the first column on the left opposite the payment method name "Authorize.Net". Also note the option "Disable X-Payments payment method" which is currently enabled):
    [[File:|700px|border]]
    
    To be able to use the imported methods, you will need to activate them. To activate a payment method, select the checkbox in the first column on the left opposite the method name.
    [[File:|700px|border]]
    
    

1. After selecting the checkbox to enable a payment method, you get access to the method configuration settings. For example, after we selected the checkbox for Authorize.Net, two additional sections appeared on the payment methods page:
   [[File:|700px|border]]
   
   Note that with a greater number of imported payment methods you will get more settings sections (a section for each imported payment method + one more section for "Use saved creedit card").
   [[File:|700px|border]]
   You can use the settings in these sections to fine-tune the way the respective payment methods will look and work for your Zoey store customers. For example, you can rename the methods or change the sort order in which they appear to the customer at checkout. For payment methods like Authorize.Net, the following settings can be adjusted:
   • Title: This field can be used to set the name for the payment method - as it should be seen by your Zoey store users. The name entered into this field will replace the name imported from X-Payments.
   • Use forced authorize operation (Work only for non-recurring product order): This setting determines how the buyer's credit card is charged when they pay you using this method:
     If this is set to Yes, a two-step process is used in which the authorization of payment is separated from the capture of the authorized payment. At the time of the initial transaction, you perform only an authorization on the buyer's card without actually capturing the funds. This corresponds to the payment status "Authorized" in X-Payments, the status XXX "X-Payments Pending payment" in the Zoey Control panel and the status "X-Payments Authorized payment" in the XXX Zoey front end. Later you need to take additional steps to capture the funds or void the authorization.
     If this is set to No, an actual charge is made on the buyer's card as soon as the buyer's payment information is processed by the payment gateway - without any further interaction on your part. In X-Payments the status of such payments appears as "Charged", which corresponds to the Zoey status "Processing".
     Some payment gateways do not support two-step payments with separate authorization and capture, so if you wish to choose the "Use forced Authorize operation" option, make sure your payment gateway supports this feature.
     The option "Use forced Authorize operation" can be used to override the value of the "Initial transaction" setting of the payment configuration used by your Zoey store - as provided on the respective Payment configuration details page in X-Payments: Setting "Use forced Authorize operation" to Yes in Zoey allows you to have a two-step payment process with separate authorization and capture - even if the payment configuration in X-Payments is configured to use the "Auth and capture" mode for the initial transaction.
   • Use forced authorize operation for recurring products: This setting is similar to "Use forced Authorize operation", but applies only to the initial fee of products with recurring profiles.
   • Sort order: This setting can be used to adjust the order in which payment method should be displayed at checkout. The required sort order position for the payment method can be set by entering the desired position number into this field. The smaller the number, the higher the position of the payment method on the list.
   • Payment from applicable countries: If necessary, you can use this setting to specify the countries for which this payment method should work.
     
2. Be sure to click the Save config button after making any changes to the configuration of your payment methods.
   [[File:|700px|border]]