Monthly Archives: March 2017

How to use Integrate third party payment gatway using xpayment?

Scenario -1

You have a payment gateway, that needs to send some datas (like total amount, API key etc) to their server and payment gateway will do all necessary things on their server and return back to your store once processing is done with payment data.

How to implement?

  1. Since it needs to redirect to payment gateway with some datas. So first select Integration type is “Redirect/Forward to Payment URL”
  2. Now enter the payment gateway URL where it need to be redirected/forwarded.
  3. Now you will have to enter all data as JSON format into Data(s) section. You can use few placeholders like {orderTotal}, {currency} etc that xpayment will handle accordingly. Xpayment also has a special placeholder {returnURL} that basically a special URL so that you can return to store from payment gateway. Most of the payment gateway, it need to supply return URL into data section OR it can be set on payment gateway control panel. Return URL denotes basically http://YOUR_DOMAIN/index.php?route=extension/payment/xpayment/confirm
  4. Now select return method type that means how your payment gateway will reply back to store. It could be GET or POST or JOSN. Normally it can be found in payment gateway manual.
  5. Finally, you will have to enter a payment successful condition. That means after returning back from Payment gateway to your store, it can be successful or failure transaction. Normally, it can be found in payment gateway manual. Most of the cases, they send some data like success==true or something like that where success is variable name that will available in their response.
  6. Now xpayment will do remaining things what to do. Either it will reject or accept depending on the data.

Scenario -2

You have a payment gateway, that needs to call their provided API URL/endpoint from your store without leaving your store. it may need to provide some data while calling that API URL.

How to implement?

1. Since it needs to call API with some datas. So first select Integration type is “API Call”
2. Now enter the payment gateway API URL that need to be called.
3. Now you will have to enter all data as JSON format into Data(s) section.
4. Now select API response type. It could be GET or POST or JOSN.
5. Finally, you will have to enter a payment successful condition.

Actually it needs some developing knowledge to integrate payment gateway.

Postal Rules in xshippingpro

Xshippingpro support following postal rules.
Rule 1:  Numeric Postal Range

Range should be defined by single hyphen (-). For example, 100-200 denotes postal codes 100 to 200. If you need multiple ranges, just separated these by comma(,). For example, 100-200,300-400.

Rule 2:  Prefix-Range  (Prefix hyphen range)

Prefix can be anything. Range should be like Rule 1 that means numeric postal range. Example: KW-10-15 denotes KW10,  KW11, KW12, KW13, KW14 and KW15

 Rule 3:  Prefix-Range-Suffix  (Prefix hyphen Range hyphen suffix)

Prefix and suffix can be anything. Range should be like Rule 1 that means numeric postal range. Example: KW-10-15-EE denotes KW10EE,  KW11EE, KW12EE, KW13EE, KW14EE and KW15EE

Rule 4: Postal codes separated by comma(,).  For example, 1000, AE1111 etc.

Finally, you can use wild cards in the prefix, suffix and single postal codes.

For example, PA2* denotes any postal code starting by PA2.

Again, KW-1-5-* denotes KW1XX, KW2XX, KW5XX and so on. Here XX means anything due to *

Several rules can be mixed together separated by comma. For example: 1200, AE-1-5-*,PA2*

Grouping in x-shipping Pro

In Xshippingpro, you can divide all shipping methods up to ten group. Why do you need grouping?  It can be used following cases:

  1. You can hide/filter out unwanted shipping method at certain scenario. For example, You have two shipping methods a. Free Shipping when order total is greater than $100 and b. Flat Shipping $20. So whenever a customer purchase products worth more than $100, it will show two shipping methods during checkout which are Free Shipping and Flat Shipping. Since it is bit awkward having free shipping and flat shipping at a same time. So you can hide Flat shipping whenever Free shipping activates. we can hide it using group feature.
  2. Merge or combine shipping cost of several shipping methods into one. For example, You want to charge $5 per product for category A and $7 per product for category B. So you have created two shipping methods. One for category A and another for Category B. Whenever customer purchase products from category A and Category B together, you want to sum up the cost. Group option can do that.
  3. Enrichment of rules –  You can link several methods into one. xshippingpro will check every rules of all the linked methods before showing it in the site. If any rules failed any of the linked methods, it will be not be appeared. For example, sometime you may want to charge shipping cost based on order total and Quantity. But xshippingpro does not support two rate type at the same method. So you can create two different methods, one method for order total and another method for quantity, then link these two methods into one using grouping option so that it validates both order total and quantity rules.

It support following group type or mode:

  1. Lowest   –  It will show the method which have lowest cost among the group methods
  2. Highest  –   It will show the method which have highest cost among the group methods
  3. Average –   It will average the cost of the group methods.
  4. Sum –   It will sum up the cost of the group methods.
  5. AND –  Special type. It has been used for rule enrichment that described in item 3 above.

For defining several method as a group, first you will have to navigate in Xshippingpro -> Global setting -> Group Option

Now select Group type from available ten groups.  You can also enter a group name. This group name will be appeared instead of Method name if group become activate during checkout. This group name can be combined with original method name and its price as well. For placing first method name, you will have to put #1, for the second method name #2 and so on. Also possible to put price like name by placing @1, @2 and so on.

Now you will have to assign your group number to the methods that you need to be linked together under general setting of each method.

Group creation is done!

Finally, it is also possible to make group from the Groups! This is called Group of groups. This group will determine based on Sort Order value defined on general tab of the each method. Shipping method having same sort order value will be placed into same group. Group of groups also can be Lowest, Highest, Average and Sum.

 

To know more details about top level grouping (Group of methods) and Second level grouping (Group of Groups), please check this

 

How to install xshippingpro in OC 2.x?

Although I am giving screenshot of xshippingpro but these steps applicable for any module. So any module can be installed by following these steps.

First, unzip downloaded zip file.

You will get another zip file named get xshippingpro.ocmod.zip

 

Now, please Go to Admin -> Extensions -> Extension Installer.

Then select “xshippingpro.ocmod.zip” and click on continue.

Now please navigate to admin -> Extensions -> Shipping. Now click on Install button located beside X-shipping pro row.

Finally, go to Admin -> Extensions -> Modifications and now click on “Refresh” button

Congrats! You are done. Now it is ready for adding shipping method. New shipping method can be added from admin -> Extensions -> Shipping