---
agentTools:
projectIndex: https://docs.mundipagg.com/llms.txt
---
# Remover desconto
Com o verbo _HTTP DELETE_, através dos identificadores do desconto (`discount_id`) e da assinatura associada (`subscription_id`) é possível remover um desconto do plano.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "Mundipagg API",
"version": "1"
},
"servers": [
{
"url": "https://api.mundipagg.com/core/v1"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "http",
"scheme": "basic"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/subscriptions/{subscription_id}/discounts/{discount_id}": {
"delete": {
"summary": "Remover desconto",
"description": "Com o verbo _HTTP DELETE_, através dos identificadores do desconto (`discount_id`) e da assinatura associada (`subscription_id`) é possível remover um desconto do plano.",
"operationId": "remover-desconto",
"parameters": [
{
"name": "subscription_id",
"in": "path",
"description": "Código da assinatura.
Formato: `sub_XXXXXXXXXXXXXXXX`.",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "discount_id",
"in": "path",
"description": "Código do desconto.
Formato: `dis_XXXXXXXXXXXXXXXX`.",
"schema": {
"type": "string"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"id\": \"dis_kqGj1JMCaGSRm9Yz\",\n \"value\": 10,\n \"discount_type\": \"percentage\",\n \"status\": \"deleted\",\n \"created_at\": \"2017-04-04T18:40:15Z\",\n \"deleted_at\": \"2017-04-04T18:40:48Z\",\n \"subscription\": {\n \"id\": \"sub_o0Jw4WYCMuPNqzGr\",\n \"code\": \"09NFPLBZY0\",\n \"start_at\": \"2017-04-04T00:00:00Z\",\n \"interval\": \"month\",\n \"interval_count\": 1,\n \"billing_type\": \"postpaid\",\n \"next_billing_at\": \"2017-05-04T00:00:00Z\",\n \"payment_method\": \"credit_card\",\n \"currency\": \"BRL\",\n \"statement_descriptor\": \"Spotify\",\n \"installments\": 1,\n \"status\": \"active\",\n \"created_at\": \"2017-04-04T18:21:17Z\",\n \"updated_at\": \"2017-04-04T18:21:17Z\"\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "dis_kqGj1JMCaGSRm9Yz"
},
"value": {
"type": "integer",
"example": 10,
"default": 0
},
"discount_type": {
"type": "string",
"example": "percentage"
},
"status": {
"type": "string",
"example": "deleted"
},
"created_at": {
"type": "string",
"example": "2017-04-04T18:40:15Z"
},
"deleted_at": {
"type": "string",
"example": "2017-04-04T18:40:48Z"
},
"subscription": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sub_o0Jw4WYCMuPNqzGr"
},
"code": {
"type": "string",
"example": "09NFPLBZY0"
},
"start_at": {
"type": "string",
"example": "2017-04-04T00:00:00Z"
},
"interval": {
"type": "string",
"example": "month"
},
"interval_count": {
"type": "integer",
"example": 1,
"default": 0
},
"billing_type": {
"type": "string",
"example": "postpaid"
},
"next_billing_at": {
"type": "string",
"example": "2017-05-04T00:00:00Z"
},
"payment_method": {
"type": "string",
"example": "credit_card"
},
"currency": {
"type": "string",
"example": "BRL"
},
"statement_descriptor": {
"type": "string",
"example": "Spotify"
},
"installments": {
"type": "integer",
"example": 1,
"default": 0
},
"status": {
"type": "string",
"example": "active"
},
"created_at": {
"type": "string",
"example": "2017-04-04T18:21:17Z"
},
"updated_at": {
"type": "string",
"example": "2017-04-04T18:21:17Z"
}
}
}
}
}
}
}
},
"404": {
"description": "404",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"message\": \"Discount not found.\"\n}"
}
},
"schema": {
"oneOf": [
{
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Subscription not found."
}
}
},
{
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Discount not found."
}
}
}
]
}
}
}
}
},
"deprecated": false,
"x-readme": {
"code-samples": [
{
"language": "csharp",
"code": "using MundiAPI.PCL;\nusing System.Web.Mvc;\n\nnamespace MundipaggTest.Controllers {\n\n public class HomeController : Controller {\n\n public ActionResult Index() {\n\n // Secret key fornecida pela Mundipagg\n string basicAuthUserName = \"SUA_CHAVE_SECRETA\";\n // Senha em branco. Passando apenas a secret key\n string basicAuthPassword = \"\";\n\n var client = new MundiAPIClient(basicAuthUserName, basicAuthPassword);\n\n string subscrptionId = \"sub_05jkdIfGYPfN26mI\";\n string discountId = \"dis_kqGj1JMCaGSRm9Yz\";\n\n var response = client.Subscriptions.DeleteDiscount(subscrptionId, discountId);\n\n return View();\n }\n}\n}",
"name": "SDK C#"
}
],
"samples-languages": [
"csharp"
]
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": false
},
"x-readme-fauxas": true,
"_id": "5aba89f6b169810058a71e9a:5aba89f6b169810058a71ed8"
}
```