Class: CartsResource
Hierarchy
default
Copy to Clipboard↳
CartsResource
Copy to Clipboard
Properties
lineItems
• lineItems: LineItemsResource
Copy to Clipboard
Defined in
medusa-js/src/resources/carts.ts:15
Methods
addShippingMethod
▸ addShippingMethod(cart_id
Copy to Clipboard, payload
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Adds a shipping method to cart
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | Id of cart |
payload Copy to Clipboard | StorePostCartsCartShippingMethodReq Copy to Clipboard | Containg id of shipping option and optional data |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:24
complete
▸ complete(cart_id
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCompleteCartRes
Copy to Clipboard>
Completes a cart. Payment authorization is attempted and if more work is required, we simply return the cart for further updates. If payment is authorized and order is not yet created, we make sure to do so. The completion of a cart can be performed idempotently with a provided header Idempotency-Key. If not provuided, we will generate one for the request.
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCompleteCartRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:43
create
▸ create(payload?
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Creates a cart
Parameters
Name | Type | Description |
---|---|---|
payload? Copy to Clipboard | StorePostCartReq Copy to Clipboard | is optional and can contain a region_id and items. The cart will contain the payload, if provided. Otherwise it will be empty |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:58
createPaymentSessions
▸ createPaymentSessions(cart_id
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Creates payment sessions. Initializes the payment sessions that can be used to pay for the items of the cart. This is usually called when a customer proceeds to checkout.
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:74
deleteDiscount
▸ deleteDiscount(cart_id
Copy to Clipboard, code
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Removes a discount from cart.
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
code Copy to Clipboard | string Copy to Clipboard | discount code to remove |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:89
deletePaymentSession
▸ deletePaymentSession(cart_id
Copy to Clipboard, provider_id
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Removes a payment session from a cart. Can be useful in case a payment has failed
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
provider_id Copy to Clipboard | string Copy to Clipboard | the provider id of the session e.g. "stripe" |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:106
refreshPaymentSession
▸ refreshPaymentSession(cart_id
Copy to Clipboard, provider_id
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Refreshes a payment session.
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
provider_id Copy to Clipboard | string Copy to Clipboard | the provider id of the session e.g. "stripe" |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:122
retrieve
▸ retrieve(cart_id
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Retrieves a cart
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:137
setPaymentSession
▸ setPaymentSession(cart_id
Copy to Clipboard, payload
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Refreshes a payment session.
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
payload Copy to Clipboard | StorePostCartsCartPaymentSessionReq Copy to Clipboard | the provider id of the session e.g. "stripe" |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:152
update
▸ update(cart_id
Copy to Clipboard, payload
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Updates a cart
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
payload Copy to Clipboard | StorePostCartsCartReq Copy to Clipboard | is required and can contain region_id, email, billing and shipping address |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Defined in
medusa-js/src/resources/carts.ts:168
updatePaymentSession
▸ updatePaymentSession(cart_id
Copy to Clipboard, provider_id
Copy to Clipboard, payload
Copy to Clipboard, customHeaders?
Copy to Clipboard): ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>
Updates the payment method
Parameters
Name | Type | Description |
---|---|---|
cart_id Copy to Clipboard | string Copy to Clipboard | is required |
provider_id Copy to Clipboard | string Copy to Clipboard | is required |
payload Copy to Clipboard | StorePostCartsCartPaymentSessionUpdateReq Copy to Clipboard | is required |
customHeaders Copy to Clipboard | Record Copy to Clipboard<string Copy to Clipboard, any Copy to Clipboard> |
Returns
ResponsePromise
Copy to Clipboard<StoreCartsRes
Copy to Clipboard>