Deactivating an item

Items can be set to active: false which will render the hosted checkout page inactive and not allow for new sign ups. Even if an item has been deactivated, you can still send transfer requests for agreements that already exist.

To set an item to inactive, simply pass in active: false in the request.

PATCH//api/v1/items

Authorization

api_key

Header parameters

Body

application/json

namestring

The name of the item

amountnumber (double)

The amount of the item, denoted in USD. Setting the value to 0 means the item's price is variable rate, and the price will be displayed as "Price varies" on the checkout page

frequencystring

The frequency with which to charge the item. Valid values: [HOUR, DAY, WEEK, MONTH, YEAR]

frequencyCountnumber (double)

The frequency count with which to charge the item. Used in combination with frequency e.g. every 2 weeks, every 1 month. A frequency count of 0 denotes a one time payment

acceptedTokensGroupedViewTokenAddresses (object)

entityIdstring

The ID of the entity. Found on your company dashboard

externalIdnullable string

External subscription ID if applicable. E.g Stripe Subscription ID

activeboolean

True means agreements can still be made with this item.

priceMetadatanullable string

Optional details related to the payment amount displayed in the cart on the hosted payment page

typeIdnumber (double)

Classification of the item. See the GET call to get the most current list

categoryIdnumber (double)

The merchant category code (also known as an MCC) ID

autoInvoiceboolean

Defaults to false. If true, then invoices will be automatically generated via the auto-invoicing feature. Delegated signing must be turned on for the entity and an inbound treasury wallet. Please contact Loop ([e-mail]) to have these enabled

initialOffsetnumber (double)

Specified in days. Says when the first invoice should be created relative to the date/time of the Item's creation

itemId*string

The external ID of the item

Response

200400401403422500504

Ok

Body

application/json

items*array of GeneralItemResponse (object)

Request

JavaScriptCurl

const response = await fetch('//api/v1/items', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {
        "itemId": "2a697faf-8fdb-4aab-be20-64db0cef7dd5"
      }
    ]),
});
const data = await response.json();

Response

{
  "items": [
    {
      "name": "The Professional Plan",
      "amount": 29.99,
      "frequency": "MONTH",
      "frequencyCount": 1,
      "acceptedTokens": {},
      "externalId": "price_1ObTC0EsKlmFX3FHDjZnmim1",
      "active": true,
      "priceMetadata": "Increases to $200 after 2 weeks",
      "autoInvoice": true,
      "initialOffset": 1,
      "itemId": "2a697faf-8fdb-4aab-be20-64db0cef7dd5",
      "entityId": "4d1f3191-935b-40c5-b91e-37e1e3700bac",
      "url": "https://checkout.loopcrypto.xyz/4d1f3191-935b-40c5-b91e-37e1e3700bac/2a697faf-8fdb-4aab-be20-64db0cef7dd5",
      "type": "Subscription",
      "category": "Books, Periodicals, and Newspapers",
      "categoryCode": 5192
    }
  ]
}