---
title: "Criação de análise de crédito"
method: POST
path: "/cards/credits/customers"
tags: ["Análise de crédito"]
---

# Criação de análise de crédito

`POST /cards/credits/customers`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/credits/customers`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Inicie o processo de análise do seu cliente para concessão de crédito.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> <span class="bkly-ref-scope-tag">scope: credit.write</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Criação de análise de crédito](/docs/criacao-analise-credito)."
}
[/block]

## Headers

- `api-version` string, required
- `Authorization` string, required: <i>Token</i> de autorização do tipo Bearer.
- `x-bkly-license` string, required

## Request body

- CreateCustomerRequest
  - `name` string: Nome completo do cliente.
  - `socialName` string: Nome pelo qual a pessoa gostaria de ser chamada. Saiba mais consultando a [Cartilha do nome social](https://www.mds.gov.br/webarquivos/publicacao/assistencia_social/Folders/cartilha_nome_social.pdf).
  - `motherName` string: Nome da mãe do cliente.
  - `birthDate` string, date-time: Data de nascimento do cliente.
  - `programId` number, required: Identificador do programa que será vinculado ao cartão.
  - `documentNumber` string, required: Número do documento (CPF ou CNPJ). Informe somente números.
  - `profession` string, required: Profissão do cliente.
  - `maritalStatus` 'Single' | 'Married' | 'Separated' | 'Divorced' | 'Widower', required: Estado civil do cliente.
  - `academicDegree` 'HighSchool' | 'Graduated' | 'PostGraduate' | 'Masters' | 'Doctorate', required: Grau de instrução do cliente.
  - `incomeBracket` 'LessThousand' | 'FromThousandToTwoThousand' | 'FromTwoThousandToThreeThousand' | 'FromThreeThousandToFiveThousand' | 'FromFiveThousandToTenThousand' | 'FromTenThousandToTwentyThousand' | 'OverTwentyThousand', required: Faixa salarial do cliente.
  - `sex` 'Male' | 'Female' | 'Other', required: Gênero do cliente.
  - `email` string, email, required: E-mail do cliente.
  - `phone` object, required: Objeto que deverá conter informações sobre o telefone do cliente.
    - `phoneType` 'Residential' | 'Commercial' | 'Mobile', required: Tipo de telefone do cliente.
    - `value` string, required: Número do telefone do cliente.
    - `countryCode` string, required: Código DDI do país.
  - `address` AddressRequest, required: Objeto que deverá conter informações sobre o endereço do cliente.
    - `zipCode` string, required: Código postal de endereço.
    - `addressLine` string, required: Logradouro (nome da rua, avenida etc.).
    - `buildingNumber` string: Número do imóvel.
    - `complement` string: Complemento do endereço.
    - `neighborhood` string, required: Nome do bairro ou distrito.
    - `city` string, required: Nome da cidade.
    - `state` string, required: Sigla do estado brasileiro
    - `country` string, required: País do endereço.
  - `scr` object, required: Objeto que deverá conter informações sobre a resposta do cliente quanto à consulta ao SCR (Sistema de Informação de Crédito).
    - `collectedAt` string, date-time, required: Data de coleta da resposta do cliente.
    - `authorized` boolean, required: Indica se o cliente autorizou (true) ou não (false) a consulta ao SCR.

## Response `202`

A solicitação foi aceita e a análise de crédito foi criada.

- CreateCustomerResponse
  - `companyKey` string: Chave que identifica o parceiro dentro do Bankly.
  - `document` string: Número de documento do cliente (CPF ou CNPJ).
  - `contract` string: Número do contrato de crédito.

## Other responses

- `400`: Há algum problema com a sua requisição.
- `401`: Acesso não autorizado.
- `404`: Recurso não encontrado.
- `409`: A solicitação conflitou com o estado atual do recurso existente no servidor.
- `422`: A sintaxe da requisição está correta, mas não foi possível processá-la devido a uma regra de negócio.
- `500`: Ocorreu algum erro inexperado em nosso servidor.

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-cr-dito.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-cr-dito/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-cr-dito/revisions/bc3eab851dee?raw)