nShift DeliveryCheckout
Our partner nShift is the market leader in delivery management solutions for ecommerce. nShift DeliveryCheckout, which is what powers Walley Checkout with delivery options, is a solution that enables the merchant to easily add new delivery options from nShift's extensive carrier library. The merchant can also easily configure business rules to handle for instance price levels for free delivery and ranking of delivery options.
nShift features
The nShift Delivery Adapter is built and hosted by Walley. The adapter communicates with nShift and fetches the list of available delivery methods based on the configuration that the merchant has created. The response from nShift is mapped to suit the adapter interface and empowers the DeliveryCheckout with options. Since new services and features are added in nShift, we might not support all the features that are available in nShift. If you are interested in a feature that is not listed below, please contact Walley.
Default Request Query Parameters
Below are the default query parameters that are always included when fetching delivery methods.
| Parameter | Explanation |
|---|---|
| currency | Currency used for the checkout session |
| language | The display language used for the checkout session. Supported language are: sv, no, fi, da, en |
| tocountry | The country code for the customer's current delivery address |
| tozipcode | The postal code for the customer's current delivery address |
| cartprice | The total price for cart |
| weight | The total weight for the cart, sum of all the article's weights sent in set cart request |
| toemail | The customer's email address |
| tostreet | The address for the customer's current delivery address |
| storetype | CustomerType for the checkout session, b2b or b2c |
Delivery options and service points
Delivery options with or without service points are the most basic setup that we support fully. Selections will be included we we attempt to create the prepared shipment.
Individual delivery option addons
Some delivery options have addons that can be configured in nShift Online. For now, we do not show any of those addons in the Delivery Module although they are not shown in the UI:
- Notification by e-mail (addon id "FCNOTIFYEMAIL")
- Notification by sms (addon id "FCNOTIFYSMS")
If they are enabled in your configuration, they will automatically be added from the customer's profile when we create the prepared shipment. The fee for such addon should always be free since there is no chance for the customer to change it.
Delivery option icon
The icon for a delivery option can be overridden by adding a General (Key / Value) values included in the result of the GET call. Add an item with Key: logoId. The available values are described under Delivery Icons.
Individual delivery option delivery dates
Some carriers have an option to enable delivery times. For now, we have support for this setting for Airmee. Others might work but we do not guarantee it. If this settings is enabled, the selection will be included when we create the prepared shipment.
Global extra data fields
Extra data fields can be added globally to your configuration. For now, we only support "Door code", which will appear on all your delivery options in the Delivery Module that does not have any service points. If this extra field is enabled, the door code will be included when we create the prepared shipment.
Global custom addons
If custom addons are added to your configuration we will show them as toggle selections with the description and price that are configured. Note that they must be added globally~~~~. An example could be to toggle express delivery for an extra fee.
Custom addons are not included in the prepared shipment. That information is only available in the get checkout response
How to get started 🚀
- Contact Walley Merchant Services for help with setup in our test environment and for questions regarding integration with Walley Checkout.
- Create a nShift DeliveryCheckout configuration. Visit nShift to read more and contact nShift for questions regaring prices, configuration etc.
- Provide Walley Merchant Services with the nShift api-credentials (
IdandSecret Id) as well as theDelivery Checkout IdandQuick Idof the sender to use. Once a DeliveryCheckout configuration is in place and properly tested in the test environment, then you are good to go. Note: Once theQuick Idhas been set it must not change.
During test and development, it is possible to use the nShift DeliveryCheckout production configuration, but it is important to note, that such setup means that purchases made in the Walley test environment will create prepared shipmentagainst your nShift production account. Ensure such prepared shipments are treated as test.
If updating the delivery configuration while running in production, read the section how to work with versions. The versions makes it possible to create a prepared shipment for customers that fetched delivery method with the older configurations.