CommunitySupport PortalYouTubeFree trialSign Up!

Discounts

Manage Discounts

Returning all discounts from the cart

get

Returns all discounts of the specified cart.

Required scopes

  • cart.cart_manage

    Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations
Path parameters
cartIdstringRequired

Cart unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Responses
200

The request was successful. Cart discounts items are returned.

application/json
get
/cart/{tenant}/carts/{cartId}/discounts
GET /cart/{tenant}/carts/{cartId}/discounts HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "id": "text",
    "yrn": "text",
    "couponYrn": "text",
    "code": "text",
    "amount": 1,
    "currency": "text",
    "discountRate": 1,
    "name": "text",
    "calculationType": "ApplyDiscountBeforeTax",
    "discountCalculationType": "SUBTOTAL",
    "valid": true,
    "links": [
      {
        "rel": "validate",
        "title": "text",
        "href": "text",
        "type": "application/json"
      }
    ],
    "discountValidationDetails": {
      "message": "text",
      "details": [
        "text"
      ]
    },
    "discountIndex": 1
  }
]

Applying a discount to cart

post

Applies a discount on the specified cart. Multiple discount coupons can be applied to cart, but you need to send a separate request for each discount coupon.

Required scopes

  • cart.cart_manage

    Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations
Path parameters
cartIdstringRequired

Cart unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Body
idstringOptional

Discount unique identifier.

couponYrnstring · min: 1Optional

A unique identifier of a global resource, which stores information about the resource, such as its type, ID or name of the tenant.

codestring · min: 1 · max: 150Required

Discount code generated when a discount coupon is created through the Coupon Service.

currencystring · min: 3 · max: 3Optional

Three-letter currency code, compliant with the ISO 4217 standard.

Pattern: [A-Z]{3}
amountnumber · doubleOptional

Discount expressed as fixed amount.

namestring · max: 150Optional

Discount displayed name.

discountRatenumber · doubleOptional

Discount expressed as a percentage of the price.

discountCalculationTypestring · enumOptional

Determines whether the coupon is applied to the total or subtotal value of the order.

Default: SUBTOTALPossible values:
calculationTypestring · enum · max: 30OptionalDeprecated

Calculation type specifies how the discount should be calculated. It can be set to one of the following:

  • ApplyDiscountBeforeTax
  • ApplyDiscountAfterTax

The field is deprecated and is not used in calculatedPrice fields. The calculated price takes into account site's settings where:

  • includesTax=true results in ApplyDiscountAfterTax
  • includesTax=false results in ApplyDiscountBeforeTax
Default: ApplyDiscountBeforeTaxPossible values:
Responses
201

The request was successful. The discount has been applied to cart.

application/json
post
/cart/{tenant}/carts/{cartId}/discounts
POST /cart/{tenant}/carts/{cartId}/discounts HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 450

{
  "code": "DEVIZU",
  "amount": 10,
  "currency": "EUR",
  "name": "Thanksgiving coupon for all orders",
  "calculationType": "ApplyDiscountBeforeTax",
  "links": [
    {
      "title": "THANKSGIVING10",
      "rel": "validate",
      "type": "application/json",
      "href": "https://api.emporix.io/couponcart/{tenant}/coupons/THANKSGIVING10"
    },
    {
      "title": "THANKSGIVING10 redeem",
      "rel": "redeem",
      "type": "application/json",
      "href": "https://api.emporix.io/couponcart/{tenant}/coupons/THANKSGIVING10/redemptions"
    }
  ]
}
{
  "yrn": "{discountYrn}",
  "discountId": "1",
  "discountIndex": 0
}

Removing all discounts from cart

delete

Removes all discounts applied to the specified cart.

Required scopes

  • cart.cart_manage

    Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations
Path parameters
cartIdstringRequired

Cart unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Query parameters
codesstringOptional

Discount codes, listed with commas, specify the discounts slated for deletion. If no codes are provided, all discounts will be removed.

Example: code1,code2
Responses
204

The request was successful. Discounts have been removed.

No content
delete
/cart/{tenant}/carts/{cartId}/discounts
DELETE /cart/{tenant}/carts/{cartId}/discounts HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Removing a discount from cart

delete

Delete the discount in the cart by the provided discount Index.

Required scopes

  • cart.cart_manage

    Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations
Path parameters
cartIdstringRequired

Cart’s unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
discountIndexstringRequired
Responses
204

The request was successful. The discount has been removed from cart.

No content
delete
/cart/{tenant}/carts/{cartId}/discounts/{discountIndex}
DELETE /cart/{tenant}/carts/{cartId}/discounts/{discountIndex} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content
PreviousCart itemsNextModels

Last updated

Was this helpful?