Category Archives: Modules

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 supports following postal rules.

Rule 1:  Numeric Postal Range

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

Rule 2:  Prefix-Range  (Prefix hyphen range)

The prefix can be anything. The range should be like Rule 1 which means numerical postal range. Example: KW-10-15 represents KW10,  KW11, KW12, KW13, KW14, and KW15

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

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

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

Rule 5: Any valid regular expression encapsulated by forward slash i.e.  / For example: /AB[0-9]{2}/

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

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

KW-1-5-* denotes KW122, KW2XX, KW5XY and so on.

Several rules can be mixed together separated by a 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.

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.

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 would appear instead of Method name if that group become activated during checkout. This group name can be combined with original method name and its price as well. For placing list of method names, please put @ and for list of prices # is needed to be placed.

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 in 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/3.x?

Although I am giving screenshots of xshippingpro, these steps apply to any module. So any module can be installed by following these steps.

  1. First, unzip the downloaded zip file e.g. xshippingpro.zip. Once you extracted, you will find several folders for different OC versions.

2. Now collect the installable file from the respective directory for your OC version. For example, if your OC version is 3.x, get the installable file from OC_3_x. The installable file name is xshippingpro.ocmod.zip

3. Now, please Go to Admin -> Extensions -> Extension Installer. Then select “xshippingpro.ocmod.zip” to install it.

4. Now please navigate to Admin -> Extensions -> Shipping. Now click the Install button of the X-shipping pro.

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

Free Shipping for a certain category and weight based shipping

I want to set up free shipping for all shoes delivered within the US. If an order contains shoes and something else, the entire order should ship free.
Otherwise, it should use shipping by weight or free shipping in us if the order is over $75.

Hi,

Thanks for contacting and purchasing xshippingpro.

After summarizing your requirements, I understood followings:

1. Shipping is free within US if order contains shoes and any other items.
2. If order total is less than $75, Shipping cost will be weight based
3. If order is total is greater than $75, Shipping is free

You did not tell about shipping outside of US. Anyway, for achieving above scenarios you need three shipping methods to be created.

Also since both item1 and item3 might be appeared at a time and both are free shipping methods, so it would not be good thing if two free shipping methods appears together. For fixing this issue, we will use group mode option. So please navigate to Xshippingpro -> Global Setting -> Group Option. Then Select Group1 is Highest.

Now lets create shipping methods

Shipping methods with shoes category:
1. Create a new method and provide a name
2. In General Setting tab, Select Group is Group1
3. In Product/Category tab, Select Category rule is “Any of the selected categories with others”. Then choose your Shoes categories.
4. In Price setting tab, Select the Shipping By to Flat. Now enter Price 0

Weight Based Shipping
1. Create another method and provide a name
2. In General Setting tab, Select Group is Group1
3. In Price setting tab, Select the Shipping By to Weight. Now enter Weight ranges (Unit Ranges) as your required. For example:

Start      End        Cost           Per Unit Block         Allow Partial
0               10           5                        0                                NO
10             20          10                      0                                NO

4. In Other tab, Enter Order Total Range 0 to 74

Total Based Shipping
1. Create another method and provide a name
2. In General Setting tab, Select Group is Group1
3. In Price setting tab, Select the Shipping By to Total. Now enter following unit ranges

Start           End           Cost Per Unit          Block Allow        Partial
75              9999999            0                               0                         NO
Thanks
Samir

Per Item based shipping cost

Let’s say I have product a called blue car.  On this one product and only this product.  I want the per item shipping to be $10.  So if let’s say you want to buy 5 blue cars, the shipping would be 5 x 10 = $50

Then all the other products.  I want it to be $2 per item. How do I do this?
Thanks for your question. We need to create two shipping methods, one for the product blue car and another for all other products. Since customer might purchase product from blue car and other products together, we have to sum up the costs of the both shipping methods in such case. For accomplishing that, we can use group mode option.
So navigate to Xshippingpro -> Global Setting -> Group Option. Now select Group1 is Sum
Okay, Lets create first shipping method:
Shipping Method for the product Blue Car
  1. Create a new method and give it a name
  2.  In General Setting tab, Select Group is Group1
  3. In Product/Category tab, Select Product Rule is Any of the selected Product with others. Then choose the product Blue Car.
  4. In Price setting tab, Select Shipping By to Quantity – Method Specific . Then add following unit ranges

Start                End            Cost              Per Unit Block            Allow Partial
0                        999            10                          1                                NO

Shipping Method for all other Products

  1. Create another method and give it a name
  2.  In General Setting tab, Select Group is Group1
  3. In Product/Category tab, Select Product Rule is Except the products with others. Then choose the product Blue Car.
  4. In Price setting tab, Select Shipping By to Quantity – Method Specific . Then add following unit ranges

Start                End            Cost              Per Unit Block            Allow Partial
0                        999             2                          1                                NO

Thanks

Few products are free and few products are paid

I have two products Prod A and Prod B.

Prod A is always FREE and shipping should not be calculated for it.

When I put both products in the cart, the shipping should only be applied to Prod B at different values. For example: Prod B cost €10 the shipping = €5. Prod B x 2 = €20 the shipping = €7. If Prod B x 2 has Prod A in the cart the shipping should still be €7.

Thanks for your question. You need two shipping methods. One for Free products (i.e Product A) and another for Paid products (i.e Product B). Also we don’t want to show Free shipping if Paid product in the cart. For that, we will have to use Group mode option. So lets first set Group  mode option

 In Global setting -> Group Option tab of xshippingpro,  Please select Group1 is Highest.
Now lets create Free method
Free Method
 
1. Create new method and provide a name
2. In general setting, select Group is Group1
3. In Products/Category tab, select product rule “Any of the selected products with others”. Choose your product A
4. In Price setting tab, select Rate type is Flat. Enter Price 0
Paid Method
 
1. Create another method and provide a name
2. In general setting, select Group is Group1
3. In Products/Category tab, select product rule “Any of the selected products with others”. Choose your product B
4. In Price setting tab, select Rate type is Quantity- Method Specific. Enter Following unit ranges
Start      End      Cost      Per Unit Block       Allow Partial
0            1            5                   0                         NO
1             2          7                   0                           NO
and so on…

Charge a flat rate per unit after a certain range

Question:
I have 5 weight ranges with a fixed rates and rest are just added according to the remaining balance of weight.
Example:-
0 kg – 1kg  = $10
1 kg – 2kg  = $25
2 kg – 3kg  = $34
3 kg – 4kg  = $41
4 kg – 5kg  = $50
There after every 1kg extra need to add $10 
 
—————-
Total ordered weight:  8.82kg
calculation:  
– first 5kg = $50
– add. 3.82kg (4kg x 10) = $40 
—————————————–
Total Cost = $90
—————————————————-
can you please help me with configuration and give me example of how to set the above in x-shipping pro plugin?
Thank you very much
warm regards
Answer:
Thanks for your question.  Please do following for achieving your scenario:
  1.  Create a new method if you did not yet.
  2.  In Price Setting tab, please select Shipping by to Weight
  3.  Now Enter Following Unit Range

Start       End         Cost            Per Unit Block      Allow Partial
0              1              10                      0                           NO
1              2               25                     0                            NO
2               3              34                      0                           NO
3               4               41                    0                            NO
4               5               50                   0                            NO

      4. Now enter Additional Unit Price  is 10
Thanks

Weight based shipping with free shipping option using xshipppingpro

Hi,
can you please help me with configuration of plugin?

I have weight type of shipping in 7 weight ranges and i need to implement also the free shipping when the total price of cart or order is more than 50 € and under 10kg?! Is something like this possible?

Thank you very much

Hi

Thanks for contacting.
For achieving your scenario, you need two shipping methods. One for weight based and another for Free shipping. Since we don’t want to show Weight based shipping if free shipping is available during checkout, so we need to use group mode for that.
So please go to Global setting -> Group Option in xshippingpro. Now Select Group1 is Lowest
Now lets make first method for weight based.
Weight Based Shipping
——————————
1. Create a new method and give it a name
2. Under General Tab, Select Group is Group1
3. Under Price Setting tab, Select Rate type is weight
4. Now Enter your unit ranges. For example:
Start       End          Cost          Per Unit Block      Allow Partial
0              10             $$                  0                          NO
10            20             $$                 0                           NO
and so on. Here $$ means shipping price for the respective ranges
Free Shipping
———————
1. Create another method and give it a name
2. Under General Tab, Select Group is Group1
3. Under Price Setting tab, Select Rate type is Total
4. Now Enter following unit ranges.
Start       End          Cost          Per Unit Block      Allow Partial
50        999999           0                  0                          NO
5. Under Other tab, Enter Weight range  0 to 10

Shipping cost based on per Unit weight

Hi, Cloud you please help me to resolve a confusion?

My store use 0.1 kg as the unit weight, the unit price for each 0.1 kg is about $0.7.

For instance:
7.33 kg Shipping cost = 73.3*$0.7 = $51.31.

How can I combine this options?

Thanks.

Thanks for your question.  For achieving your goal, please do followings.

  1. Under Price setting tab, select the Shipping by to Weight
  2.  Now Enter Unit Ranges as follows

Start    End       Cost        Per Unit Block       Allow Partial
0            1000       0.7             0.1                                 NO