# Criar Plano de Taxas

## Criar plano de taxas

> Cria um plano para o intermediador sem associar a um vendedor

```json
{"openapi":"3.0.0","info":{"title":"Barte Payment Service API - Planos de Taxas","version":"1.0.0"},"servers":[{"url":"https://api.barte.com","description":"Servidor de Produção"},{"url":"https://sandbox-api.barte.com","description":"Servidor de Sandbox"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Token-Api","description":"Token do seller principal para autenticação"}},"schemas":{"RatePlanRequest":{"type":"object","required":["name","tax"],"properties":{"name":{"type":"string","description":"Nome do plano de taxas"},"tax":{"$ref":"#/components/schemas/TaxConfig","description":"Configuração das taxas finais aplicadas ao seller"}}},"TaxConfig":{"type":"object","required":["pix","bankSlip","debit","credit"],"properties":{"pix":{"$ref":"#/components/schemas/PixTax"},"bankSlip":{"$ref":"#/components/schemas/BankSlipTax"},"debit":{"$ref":"#/components/schemas/DebitTax"},"credit":{"$ref":"#/components/schemas/CreditConfig"}}},"PixTax":{"type":"object","required":["delayForRedeem","value","rateType"],"properties":{"delayForRedeem":{"type":"integer","description":"Dias para saque"},"value":{"type":"number","format":"double","description":"Percentual da taxa (ex: 0.5 para 0.5%)"},"rateType":{"type":"string","enum":["PERCENTAGE"],"description":"Sempre \"PERCENTAGE\" para Pix"},"valueLimit":{"type":"number","format":"double","description":"Valor máximo permitido (opcional)"}}},"BankSlipTax":{"type":"object","required":["delayForRedeem","value","rateType"],"properties":{"delayForRedeem":{"type":"integer","description":"Dias até o saque"},"value":{"type":"number","format":"double","description":"Valor da taxa"},"rateType":{"type":"string","enum":["PERCENTAGE","FIXED"],"description":"Aceita apenas 'PERCENTAGE' ou 'FIXED'"},"valueLimit":{"type":"number","format":"double","description":"Não incluir quando rateType for \"FIXED\""}}},"DebitTax":{"type":"object","required":["delayForRedeem","value","rateType"],"properties":{"delayForRedeem":{"type":"integer","description":"Dias para saque"},"value":{"type":"number","format":"double","description":"Percentual da taxa"},"rateType":{"type":"string","enum":["PERCENTAGE"],"description":"Apenas \"PERCENTAGE\" é aceito para débito"}}},"CreditConfig":{"type":"object","required":["online","pos","tap"],"properties":{"online":{"$ref":"#/components/schemas/CreditOnline"},"pos":{"$ref":"#/components/schemas/CreditPos"},"tap":{"$ref":"#/components/schemas/CreditTap"}}},"CreditOnline":{"type":"object","required":["delayForRedeem","default"],"properties":{"delayForRedeem":{"type":"integer","description":"Dias para saque"},"default":{"$ref":"#/components/schemas/CreditDefault"},"mastercard":{"$ref":"#/components/schemas/CreditDefault"},"visa":{"$ref":"#/components/schemas/CreditDefault"},"hipercard":{"$ref":"#/components/schemas/CreditDefault"},"elo":{"$ref":"#/components/schemas/CreditDefault"},"discover":{"$ref":"#/components/schemas/CreditDefault"},"american_express":{"$ref":"#/components/schemas/CreditDefault"}}},"CreditDefault":{"type":"object","required":["sellerRates"],"properties":{"sellerRates":{"type":"array","items":{"type":"number","format":"double"},"maxItems":24,"description":"Lista com até 24 taxas por parcela (%)"}}},"CreditPos":{"type":"object","required":["delayForRedeem","default"],"properties":{"delayForRedeem":{"type":"integer","description":"Dias para saque"},"default":{"$ref":"#/components/schemas/CreditDefault"},"mastercard":{"$ref":"#/components/schemas/CreditDefault"},"visa":{"$ref":"#/components/schemas/CreditDefault"},"hipercard":{"$ref":"#/components/schemas/CreditDefault"},"elo":{"$ref":"#/components/schemas/CreditDefault"},"discover":{"$ref":"#/components/schemas/CreditDefault"},"american_express":{"$ref":"#/components/schemas/CreditDefault"}}},"CreditTap":{"type":"object","required":["delayForRedeem","default"],"properties":{"delayForRedeem":{"type":"integer","description":"Dias para saque"},"default":{"$ref":"#/components/schemas/CreditDefault"},"mastercard":{"$ref":"#/components/schemas/CreditDefault"},"visa":{"$ref":"#/components/schemas/CreditDefault"},"hipercard":{"$ref":"#/components/schemas/CreditDefault"},"elo":{"$ref":"#/components/schemas/CreditDefault"},"discover":{"$ref":"#/components/schemas/CreditDefault"},"american_express":{"$ref":"#/components/schemas/CreditDefault"}}},"RatePlanResponse":{"type":"object","properties":{"id":{"type":"integer","description":"ID do plano criado"}}},"Error":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorDetail"},"minItems":1}}},"ErrorDetail":{"type":"object","required":["code","title","description"],"properties":{"code":{"type":"string","enum":["BAR-3011","BAR-3012","BAR-3013","BAR-3023","BAR-3027","BAR-3028","BAR-3029","BAR-3033"],"description":"Código específico do erro"},"title":{"type":"string","description":"Título do erro"},"description":{"type":"string","description":"Descrição detalhada do erro"}}}}},"paths":{"/v2/payfac/rate-plans":{"post":{"summary":"Criar plano de taxas","description":"Cria um plano para o intermediador sem associar a um vendedor","tags":["Planos de Taxas"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RatePlanRequest"}}}},"responses":{"200":{"description":"Plano de taxas criado com sucesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RatePlanResponse"}}}},"400":{"description":"Dados inválidos na requisição","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Token de autenticação inválido ou ausente"},"403":{"description":"Acesso negado"},"404":{"description":"Recurso não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```