Attach Discount To Invoice Item

POST

/api/:account_id/discounts/invoice-item/:invoice_item_external_id

POST

/api/:account_id/discounts/invoice-item/:invoice_item_external_id

$ curl -X POST https://app.paymentkit.com/api/account_id/discounts/invoice-item/invoice_item_external_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "coupon_id": "cpn_9f8e7d6c5b4a3"
> }'

1 {
2   "id": "dsc_1234567890abcdef",
3   "coupon_id": "cpn_9f8e7d6c5b4a3",
4   "promotion_code_id": "promo_2024spring",
5   "attachment_level": "invoice_item",
6   "customer_id": "cust_9876543210fedcba",
7   "subscription_id": "sub_1122334455667788",
8   "invoice_id": "inv_20240115093000",
9   "invoice_item_id": "item_556677889900aabb",
10   "start_date": "2024-01-15T09:30:00Z",
11   "end_date": "2024-02-15T09:30:00Z",
12   "is_active": true,
13   "metadata": {},
14   "created_at": "2024-01-15T09:30:00Z",
15   "updated_at": "2024-01-15T09:30:00Z"
16 }

Attach a discount to a specific invoice item.

Item-level discounts are always one-time and apply to that specific item.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

invoice_item_external_idstringRequired

account_idstringRequired

Request

This endpoint expects an object.

coupon_idstringRequired

ID of the coupon to apply

promotion_codestring or nullOptional

Optional promotion code used to apply this coupon

start_datedatetime or nullOptional

When the discount becomes active (defaults to now)

end_datedatetime or nullOptional

When the discount expires (based on coupon duration if not set)

metadatamap from strings to any or nullOptional

Arbitrary metadata

Response

Successful Response

idstring

coupon_idstring

promotion_code_idstring or null

attachment_levelstring

customer_idstring or null

subscription_idstring or null

invoice_idstring or null

invoice_item_idstring or null

start_datedatetime

end_datedatetime or null

is_activeboolean

metadatamap from strings to any or null

created_atdatetime

updated_atdatetime

Errors

422

Unprocessable Entity Error