Creating a product microsite

Product or commerce based microsites are an opportunity to let your brand stand out and create a focused experience around your products. We bring speed and flexibility when launching a microsite with Upcale. Mix and match the services you need - product information, commerce, intellegent services, distributed order management.

Works with new or existing sites

Display products

Product details, Commerce enabled, 1-tap buy

Listing Products

From your application bundle id, retrieve everything you need to display a list of products and/or categories.

When the app is launched, retrieve the experience associated with the app.

GETcontent-repository/platforms/{platform}/bundles/{bundleId}

subdirectory_arrow_right Experience ID

From the experience, retrieve the active edition.

GET/content-repository/editions?active=active&ids={experienceId}

subdirectory_arrow_right Active Edition ID

To get the active/published categories from the selling tree ID.

GET/product-content/products?editionId={editionId}

subdirectory_arrow_right Products from the active Edition

Checkout

A multi-step checkout flow vs. 1 large form for checkout is recommended based on the calls you need to make to return methods and prices.

Create a draft order

From shipping address, retrieve shipping methods and fees

Costs are updated to the order draft. Costs are shopping, tax and product related

Obtain authorization for the order using a payment method

Create an order draft when user adds a product to the cart.

Update order draft with subsequent cart additions/edits/subtractions.

The calculateCost method will retrieve your shipping methods (with a default). Use the same method to update costs when selecting a shipping method.

Create order draft

An order in draft status should be created when a guest or registered customers add items to a cart or purchase through one-tap buy. For registered customers the draft is posted with the customer number. In the case of guest customers, the session-ID is used. The product details and quantities are also posted at the same time.

POSTorder-broker/orders

subdirectory_arrow_right Order ID

Add/edit/remove products from cart (update order draft)

Subsequent products added to cart after the inital POST will use this call.

POSTorder-broker/orders/{order ID}/orderlines/addBatch

subdirectory_arrow_right Order draft updated

To update a product in the cart, such as a quantity change.

POSTorder-broker/orders/{order ID}/orderlines/updateBatch

subdirectory_arrow_right Order draft updated

To remove a product from cart.

POSTorder-broker/orders/{order ID}/orderlines/deleteBatch

subdirectory_arrow_right Order draft updated

Update costs on order draft

Customer fills out shipping details. Post to calculateCost with shipping location to return valid shipping methods. This call also updates tax costs to order draft.

POSTorder-broker/orders/{order ID}/calculateCost

subdirectory_arrow_right Shipping methods

Post to calculateCost again with the selected shipping method and the order draft will be updated with shipping costs and tax if method is different than default.

POSTorder-broker/orders/{order ID}/calculateCost

subdirectory_arrow_right Order is updated with tax, shipping costs

Authorize payment

Obtain authorization for the order using this method. Cybersource provides an authorization status to the mobile app.

POSTpayment-service/cybersource/authorization

subdirectory_arrow_right Authorization status repsonse

Place order

Order is placed with applicable tax, shipping + billing address and shipping method.

POSTorder-broker/orders/{order ID}/placeOrder

subdirectory_arrow_right Order status response

After order is placed, Upswing takes care of email notifications to the customer based on the state of the order.

Order confirmation

The placeOrder call will return the updated order object and can be used when displaying the cofirmation screen after checkout has been completed.