v1

latestOpenAPI 3.1.02026-07-241040774.6 KB

Remover uso

Com o verbo HTTP DELETE, através dos identificadores do uso (usage_id), do item (subscription_item_id) a da assinatura associada (subscription_id), é possível excluir o uso do item de uma assinatura.

delete/subscriptions/{subscription_id}/items/{item_id}/usages/{usage_id}

Path parameters

subscription_idstring required

Código da assinatura.<br>Formato: sub_XXXXXXXXXXXXXXXX.

item_idstring required

Código do item da assinatura.<br>Formato: si_XXXXXXXXXXXXXXXX.

usage_idstring required

Código do uso.<br>Formato: usage_XXXXXXXXXXXXXXXX.

Response

200

idstring
quantityinteger
statusstring
used_atstring
created_atstring
deleted_atstring

Example response

{
  "id": "usage_QV1gBLhalU35RNbx",
  "quantity": 1,
  "status": "deleted",
  "used_at": "2017-04-04T18:21:50Z",
  "created_at": "2017-04-04T18:21:50Z",
  "deleted_at": "2017-04-04T18:24:57Z",
  "subscription_item": {
    "id": "si_EJ8lP61Cotbyz9jx",
    "description": "Bola",
    "quantity": 1,
    "status": "active",
    "created_at": "2017-04-04T18:21:18Z",
    "updated_at": "2017-04-04T18:21:18Z",
    "subscription": {
      "id": "sub_o0Jw4WYCMuPNqzGr",
      "code": "09NFPLBZY0",
      "start_at": "2017-04-04T00:00:00Z",
      "interval": "month",
      "interval_count": 1,
      "billing_type": "postpaid",
      "next_billing_at": "2017-05-04T00:00:00Z",
      "payment_method": "credit_card",
      "currency": "BRL",
      "statement_descriptor": "Spotify",
      "installments": 1,
      "status": "active",
      "created_at": "2017-04-04T18:21:17Z",
      "updated_at": "2017-04-04T18:21:17Z"
    }
  }
}