Overview

The jsma cart provides access to the current session cart object. Whenever a user creates a session, a cart object will be created lazily (it will be created when first time accessing JSMA carts method carts.current).

Index

Usage

writing data

Here is an example on how to write data to a JSMA cart:

# TODO

reading data

Here is an example on how to read data from a JSMA cart:

# TODO

Methods

The JSMA cart provides the following methods:

cartItem cart.addItem(product_id, [project], [custom_price])

Adds an item to the items list of JSMA cartItem

Returns the new cartItem.

Example

...
cart.addItem(1);
...

Parameter product_id (required)

Parameter project (optional)

Parameter custom_price (optional)

cartItem cart.addItemFromOrderItem(item_uuid)

Adds a JSMA orderItem* (specified by uuid) to the *items* list of *JSMA cartItem

Returns the new cartItem.

Example

...
cart.addItemFromOrderItem(1);
...

Parameter item_uuid (required)

cartItem cart.addVoucher([token])

If a valid voucher token was given as first argument this method will add a voucher to the cart and return a corresponding JSMA cartItem

Example

...
cart.addVoucher('A_VALID_VOUCHER_TOKEN')
...

Parameter token (optional)

cart.flexAttributes

Returns the flex attributes associated with the cart

Example

...
cart.flexAttributes
...

cart.get(key)

Accesses a flex attribute field for the given parameter key

Example

...
cart.get(key)
...

Parameter key (required)

cart.has(key)

Returns true if a cart has a flex attribute for the given parameter key, otherwise false.

Example

...
cart.has(key)
...

Parameter key (required)

address cart.invoiceAddress

Returns the invoice address as JSMA address.

Example

...
cart.invoiceAddress // => address
...

cartItem[] cart.items

Returns a list of cartItems.

Example

...
cart.items
...

string cart.paymentMethod

Returns the paymentMethod field of a cart.

Example

...
cart.paymentMethod // => 'paypal'
...

string cart.paypalPurchaseUrl(return_url, cancel_url)

Returns the URL to purchase a cart with paypal.

Example

...
cart.paypalPurchaseUrl('http://my-website.com/success', 'http://my-website.com/cart')
...

Parameter return_url (required)

The URL to which the user will be redirected after finishing the transaction on the paypal website.

Parameter cancel_url (required)

The URL to which the user will be redirected when cancelling the transaction on the paypal website.

portal cart.portal

Returns the JSMA portal of the cart.

Example

...
cart.portal
...

int cart.price

Returns the price of the cart in cents

Example

...
cart.price // => 1995
...

void cart.removeItem(uuid)

Removes the cartItem specified by uuid from the cart.

Example

...
cart.removeItem('A_UUID_OF_A_CARTITEM');
...

Parameter uuid (required)

A uuid from the list of JSMA cartItems of the cart.

cart.set(key, value)

Sets a flex attribute with the given parameters

Example

...
cart.set(key, value)
...

Parameter key (required)

Parameter value (required)

cart.remove(key)

Removes a flex attribute for given parameter key.

Example

...
cart.remove(key)
...

Parameter key (required)

void cart.setPaymentMethod(payment_mode)

Sets the paymentMethod of the cart to the specified value.

Example

...
cart.setPaymentMethod('invoice');
...

Parameter payment_mode (required)

void cart.setShipping(cent)

Sets the shipping cost of the cart.

Example

...
cart.setShipping(495);
...

Parameter cent (required)

bool cart.setShippingMode(shipping_mode)

Sets the shippingMode to the desired value. Returns true if update was successful.

Example

...
cart.setShippingMode('shipping_normal_xl'); // => true
...

Parameter shipping_mode (required)

May be either of

• store
• shipping_normal
• shipping_normal_xl
• shipping_express
• shipping_express_xl

int cart.shipping

Returns the shipping cost in cents.

Example

...
cart.shipping // => 495
...

address cart.shippingAddress

Returns the shipping address as JSMA address.

Example

...
cart.shippingAddress // => JSMA address
...

int cart.tax

Returns the included VAT of the cart in cents.

Example

...
cart.tax // => 205
...

cartItem cart.updateItem(product_id, project, uuid)

Replace a cartItem by uuid with a new one.

Example

...
cart.updateItem(product_id, project, uuid)
...

Parameter product_id (required)

Parameter project (required)

Parameter uuid (required)

string cart.uuid

Returns the cart's uuid.

Example

...
cart.uuid
...