Add Custom Discount To Cart Item

POST 
https://useast.api.elasticpath.com/v2/carts/:cartID/items/:cartitemID/custom-discounts

Use this endpoint to add a custom discount to cart item.

Request

Path Parameters

cartID stringrequired

Specifies the ID for the cart.

cartitemID stringrequired

Specifies the unique identifier for the cart item.

application/json

Body

amount numberrequired

Specifies an amount to be applied for the custom discount. It must be less than zero.

description stringrequired

Specifies a description for the custom discount.

discount_code stringrequired

Specifies the discount code used for the custom discount.

discount_engine stringrequired

Specifies from where the custom discount is applied. For example, Talon.one.

external_id stringrequired

Specifies an external id for the custom discount.

type stringrequired

Specifies the type of the resource. Always custom_discount.

Responses

200

Response Headers

application/json

Schema

Schema

data object

amount object

amount number

Specifies an amount to be applied for the custom discount. It must be less than zero.

currency string

The currency set for the custom discount.

formatted string

The formatted value for the custom discount.

description string

Specifies a description for the custom discount.

discount_code string

Specifies the discount code used for the custom discount.

discount_engine string

Specifies from where the custom discount is applied. For example, Talon.one.

external_id string

Specifies an external id for the custom discount.

type string

Specifies the type of the resource. Always custom_discount.

id uuid

Specifies the UUID of the custom discount.

Example (auto)

{
  "data": {
    "amount": {
      "amount": 0,
      "currency": "string",
      "formatted": "string"
    },
    "description": "string",
    "discount_code": "string",
    "discount_engine": "string",
    "external_id": "string",
    "type": "string",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

401

Unauthorized

application/json

Schema

Schema

detail string
status string
title string

Example (auto)

[
  null
]

Example

{
  "errors": {
    "status": 401,
    "title": "Unauthorized"
  }
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://useast.api.elasticpath.com/v2/carts/:cartID/items/:cartitemID/custom-discounts");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <TOKEN>");
var content = new StringContent("{\n  \"amount\": 0,\n  \"description\": \"string\",\n  \"discount_code\": \"string\",\n  \"discount_engine\": \"string\",\n  \"external_id\": \"string\",\n  \"type\": \"string\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://useast.api.elasticpath.com

Auth

Bearer Token

Parameters

cartID — pathrequired

cartitemID — pathrequired

Body

Content-Type

application/jsonrequired

{
  "amount": 0,
  "description": "string",
  "discount_code": "string",
  "discount_engine": "string",
  "external_id": "string",
  "type": "string"
}

ResponseClear

Click the Send API Request button above and see the response here!