Sign in

v1

latestOpenAPI 3.0.12026-07-242871595.3 MB
PLANS

Delete a plan

Deletes a plan based on the planId.

delete/v1/plans/{planId}

Path parameters

planIdstring required

Universally unique identifier (UUID) of a plan.

Headers

X-Clover-Merchant-Idstring required

Clover merchant identifier (mId).

Content-Typestring

Content type, for example: application, JSON.

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <application>/<version>

Response

Successful response. Plan is deleted.

idstring

Plan identifier.

namestring

Plan name.

merchantIdstring

Merchant identifier.

taxRateUuidsstring[]

Tax rate universally unique identifiers (UUIDs).

tipAmountstring

Tip amount.

amountstring

Plan amount.

activeboolean

Indicates whether the plan is active. Values:

  • True
  • False
interval'DAY' | 'MONTH' | 'WEEK' | 'YEAR'

Plan interval. Example: Daily, weekly, semi-monthly, monthly, quarterly, yearly. See Interval Matrix table for details.

intervalCountinteger

Number of times the plan interval occurs.

productUuidstring

Product universally unique identifier (UUID).

notestring

Additional information or note related to the plan.

createdTimestring date-time

Time when the plan was created.

modifiedTimestring date-time

Time when the plan was modified.

deletedTimestring date-time

Time when the plan was deleted.

subscriptionCountinteger

Number of subscriptions in the plan.

subscriptionPaidTotalAmountinteger

Total paid amount for subscriptions in the plan.

lastRunDatestring date-time

Last run date for the plan.

objectstring

Example response

{
  "note": "note",
  "modifiedTime": "2000-01-23T04:56:07.000Z",
  "amount": "amount",
  "tipAmount": "tipAmount",
  "subscriptionCount": 6,
  "active": true,
  "lastRunDate": "2000-01-23T04:56:07.000Z",
  "taxRateUuids": [
    "taxRateUuids",
    "taxRateUuids"
  ],
  "productUuid": "productUuid",
  "merchantId": "merchantId",
  "subscriptionPaidTotalAmount": 1,
  "intervalCount": 0,
  "name": "name",
  "createdTime": "2000-01-23T04:56:07.000Z",
  "interval": "DAY",
  "id": "id",
  "deletedTime": "2000-01-23T04:56:07.000Z",
  "object": "object"
}