# Criar Sessão 3DS

## Criar Sessão 3DS

> Cria uma sessão 3DS e retorna os dados necessários para coleta de informações do navegador.\n\n ⚠️ IMPORTANTE: A sessão 3DS só consegue ser testada completamente em produção.

```json
{"openapi":"3.0.3","info":{"title":"API de 3D Secure (3DS)","version":"2.0.0"},"servers":[{"url":"https://api.barte.com","description":"Servidor de Produção (recomendado para testes 3DS)"},{"url":"https://sandbox-api.barte.com","description":"Servidor de Sandbox (limitações para 3DS)"}],"security":[{"X-Token-Api":[]}],"components":{"securitySchemes":{"X-Token-Api":{"type":"apiKey","name":"X-Token-Api","in":"header"}},"schemas":{"CreateThreeDSSessionRequest":{"type":"object","required":["sourceType","cardId"],"properties":{"sourceType":{"type":"string","enum":["card"],"description":"Tipo da fonte de pagamento"},"cardId":{"type":"string","format":"uuid","description":"ID do cartão retornado na tokenização"}}},"ThreeDSSessionResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID da sessão (setupId) - usado posteriormente no pagamento"},"token":{"type":"string","description":"JWT usado no script de coleta de dados"},"collectUrl":{"type":"string","format":"uri","description":"URL onde o navegador enviará dados de background"},"providerType":{"type":"string","enum":["CYBERSOURCE"],"description":"Tipo do provedor 3DS"}}},"ErrorResponse":{"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","NOT_ACCEPTABLE","UNSUPPORTED_MEDIA_TYPE","3DS-0001","3DS-0002","3DS-0003"]},"title":{"type":"string","enum":["BUSINESS_SELLER","BUSINESS_CHECKOUT","BUSINESS_COMMON","BUSINESS_SECURITY","BUSINESS_SUBSCRIPTION","INVALID_REQUEST_PARAM","BUSINESS_METRIC","BUSINESS_ACCOUNTANCY","BUSINESS_NOTIFICATION","BUSINESS_BARTE","BUSINESS_COMPANY","BUSINESS_INVOICE","BUSINESS_TRANSFER","BUSINESS_CARD","BUSINESS_ORDER","BUSINESS_3DS","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":{"/v1/3ds/session":{"post":{"tags":["Criação de Sessão 3DS"],"summary":"Criar Sessão 3DS","description":"Cria uma sessão 3DS e retorna os dados necessários para coleta de informações do navegador.\\n\\n ⚠️ IMPORTANTE: A sessão 3DS só consegue ser testada completamente em produção.","operationId":"createThreeDSSession","requestBody":{"description":"Dados para criação da sessão 3DS","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateThreeDSSessionRequest"}}}},"responses":{"201":{"description":"Sessão 3DS criada com sucesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSSessionResponse"}}}},"400":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Acesso proibido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Erro interno do servidor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```