You are viewing an old version of the API

All Versions

Delete discount
V1

Square V1 APIs
We recommend using the Square API (V2) for all new development when possible. See When to use Connect V1 to learn more about working with V1 endpoints.

Deprecated

Effective November 20th, 2019

Deletes an existing discount.

DeleteDiscount returns nothing on success but Connect SDKs map the empty response to an empty V1DeleteDiscountRequest object as documented below.

Required permissions: ITEMS_WRITE

Deprecation date

2019-11-20

Retirement date

2020-11-18

Replaced by

DeleteCatalogObject Migration guide

Path Parameters

Name	Description
`location_id string` Required	The ID of the item's associated location.
`discount_id string` Required	The ID of the discount to delete.

Response Fields

Name	Description
`id string`	The discount's unique ID.
`name string`	The discount's name.
`rate string`	The rate of the discount, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%. This rate is 0 if discounttype is VARIABLEPERCENTAGE.
`amount_money Money`	The amount of the discount. This amount is 0 if discounttype is VARIABLEAMOUNT. This field is not included for rate-based discounts.
`discount_type string`	Indicates whether the discount is a FIXED value or entered at the time of sale.
`pin_required boolean`	Indicates whether a mobile staff member needs to enter their PIN to apply the discount to a payment.
`color string`	The color of the discount's display label in Square Point of Sale, if not the default color. The default color is 9da2a6.
`v2_id string`	The ID of the CatalogObject in the Connect v2 API. Objects that are shared across multiple locations share the same v2 ID.

Examples

All Versions

curl https://connect.squareup.com/v1/location_id0/discounts/discount_id1 \
  -X DELETE \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Catalog API You are viewing an old version of the API 2020-06-25 Version 2020-06-25 All Versions Catalog API Delete discount V1 Square V1 APIs We recommend using the Square API (V2) for all new development when possible. See When to use Connect V1 to learn more about working with V1 endpoints.