# Criar Assinatura

## Criar assinatura

> Cria uma nova assinatura

```json
{"openapi":"3.0.0","info":{"title":"Barte Payment Service API - Assinaturas","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 de autenticação para acesso à API"}},"schemas":{"SubscriptionRequest":{"type":"object","required":["uuidPlan","basicValue","payment","uuidBuyer","startDate"],"properties":{"uuidPlan":{"type":"string","format":"uuid"},"basicValue":{"$ref":"#/components/schemas/BasicValueRequest"},"additionalValue":{"$ref":"#/components/schemas/AdditionalValueRequest"},"payment":{"$ref":"#/components/schemas/PaymentRequest"},"uuidBuyer":{"type":"string","format":"uuid"},"startDate":{"type":"string","format":"date"},"metadata":{"type":"array","items":{"$ref":"#/components/schemas/MetadataRequest"}}}},"BasicValueRequest":{"type":"object","required":["type","valuePerMonth"],"properties":{"type":{"type":"string","enum":["MONTHLY","SEMESTER","YEARLY"]},"valuePerMonth":{"type":"number","format":"double"}}},"AdditionalValueRequest":{"type":"object","properties":{"installments":{"type":"integer"},"value":{"type":"number","format":"double"}}},"PaymentRequest":{"type":"object","required":["method"],"properties":{"method":{"type":"string","enum":["CREDIT_CARD","PIX","BANK_SLIP"]},"card":{"$ref":"#/components/schemas/CardRequest"},"fraudData":{"$ref":"#/components/schemas/FraudDataRequest"}}},"CardRequest":{"type":"object","properties":{"holderName":{"type":"string"},"number":{"type":"string"},"expiration":{"type":"string"},"cvv":{"type":"string"},"buyerUuid":{"type":"string"}}},"FraudDataRequest":{"type":"object","required":["email","name"],"properties":{"document":{"type":"string"},"email":{"type":"string","format":"email"},"name":{"type":"string"},"phone":{"type":"string"}}},"MetadataRequest":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}},"SubscriptionResponse":{"type":"object","properties":{"uuid":{"type":"string"},"status":{"type":"string","enum":["PENDING","ACTIVE","DEFAULTER","INACTIVE"]},"customer":{"$ref":"#/components/schemas/CustomerResponse"},"startDate":{"type":"string","format":"date"},"value":{"$ref":"#/components/schemas/BasicValueResponse"},"additionalValue":{"$ref":"#/components/schemas/AdditionalValueResponse"},"paymentMethod":{"type":"string","enum":["CREDIT_CARD","PIX","BANK_SLIP"]},"charges":{"type":"array","items":{"$ref":"#/components/schemas/ChargeResponse"}}}},"CustomerResponse":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"document":{"type":"string"}}},"BasicValueResponse":{"type":"object","properties":{"type":{"type":"string","enum":["MONTHLY","SEMESTER","YEARLY"]},"valuePerMonth":{"type":"number","format":"double"}}},"AdditionalValueResponse":{"type":"object","properties":{"installments":{"type":"integer"},"value":{"type":"number","format":"double"}}},"ChargeResponse":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["ABANDONED","CANCELED","CHARGEBACK","DISPUTE","FAILED","LATE","PAID","PAID_MANUALLY","PRE_AUTHORIZED","REFUND","SCHEDULED"]},"value":{"type":"number","format":"double"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"Error":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorDetail"}},"metadata":{"$ref":"#/components/schemas/Metadata"}}},"ErrorDetail":{"type":"object","properties":{"status":{"type":"string"},"code":{"type":"string","enum":["PAYMENT-0000","PAYMENT-0500","PAYMENT-9999","BAR-7001","BAD_REQUEST","FORBIDDEN","METHOD_NOT_ALLOWED"]},"title":{"type":"string","enum":["INVALID_REQUEST_PARAM","card_not_supported"]},"description":{"type":"string"},"action":{"type":"string"},"additionalInfo":{"type":"object","additionalProperties":{"type":"object"}}}},"Metadata":{"type":"object","properties":{"totalRecords":{"type":"integer"},"totalPages":{"type":"integer"},"requestDatetime":{"type":"string","format":"date-time"}}}}},"paths":{"/v2/subscriptions":{"post":{"summary":"Criar assinatura","description":"Cria uma nova assinatura","tags":["Assinaturas"],"parameters":[{"name":"X-Token-Api","in":"header","required":true,"schema":{"type":"string"},"description":"Token de autenticação para acesso à API"},{"name":"Content-Type","in":"header","required":false,"schema":{"type":"string","enum":["application/json"]},"description":"Tipo de conteúdo da requisição"},{"name":"x-ip-origin-request","in":"header","required":false,"schema":{"type":"string"},"description":"IP de origem da requisição"},{"name":"x-idempotency-key","in":"header","required":false,"schema":{"type":"string"},"description":"Chave de idempotência para evitar duplicidade"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionRequest"}}}},"responses":{"201":{"description":"Assinatura criada com sucesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionResponse"}}}},"400":{"description":"Erro de validação ou negócio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Token inativo ou inexistente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Acesso negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Tipo de mídia não suportado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro interno do servidor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```