POST
Cria uma proposta de contratação de CDC Hub
Cria a proposta de CDC Hub a partir de uma simulação: informe o code retornado em Simular e o period (nº de parcelas) escolhido. Criada a proposta, ela vira uma Operação, acompanhe pela aba Operações.

Bloco customer (opcional)

Você pode enviar os dados cadastrais do cliente junto com a contratação. O bloco é opcional: campos preenchidos atualizam o cadastro; campos omitidos preservam o valor existente.
O cadastro do cliente precisa estar completo para a proposta seguir. Se faltar algum campo obrigatório, a API responde com erro nomeando os campos que faltam.
O e-mail do cliente precisa ter formato válido, como nome@dominio.com. A regra vale para o customer.email enviado e também para o e-mail que já estava no cadastro. Um e-mail inválido é recusado com a mensagem “Dados do cliente inválidos: email.”, depois da checagem dos campos que faltam, e a proposta não é criada.
O CPF não vai no bloco customer — ele já está vinculado à operação identificada pelo code.

Diferença para Empréstimo Pessoal

No CDC Hub, os dados bancários (bankAccountBankCode, bankAccountType, bankAccountAgency, bankAccountAgencyDigit, bankAccountNumber, bankAccountDigit) não são obrigatórios, porque o crédito é depositado na conta do lojista, não do cliente.

Campos de referência

Campos que melhoram a análise de crédito

Os campos profession, companyName, startEmploymentDate e monthlyIncome são opcionais, mas melhoram a análise de crédito. Envie-os sempre que possível.

Forma de pagamento (paymentMethod, opcional)

Disponível apenas para lojas com o pagamento por chave PIX habilitado pela HubCred. Sem a habilitação, uma proposta com paymentMethod igual a 2 é recusada. Fale com o seu contato na HubCred para habilitar.
Qualquer outro valor é recusado. A forma de pagamento é validada antes dos dados do cliente. Com paymentMethod igual a 2, o crédito é pago na chave PIX cadastrada da loja. Você não envia a chave. Se a loja não tiver chave PIX cadastrada, a proposta é recusada. O campo customer.bankPix (até 120 caracteres) pode ser enviado para atualizar o cadastro do cliente, mas não é usado para o pagamento do CDC Hub.

Produto (product)

Descrição livre do produto financiado (por exemplo, o bem ou serviço vendido). Obrigatório quando a loja usa a análise de crédito automática; nas demais lojas é opcional. Numa loja com análise automática, a proposta sem product é recusada com a mensagem “Informe o produto para enviar a proposta para análise.”
O produto é verificado depois dos dados do cliente: se o cadastro estiver incompleto, o erro que nomeia os campos que faltam vem antes do erro do produto.

Body

Input com os dados para a proposta e o cadastro do cliente

Dados de entrada para criar uma proposta de CDC Hub.

code
string | null

Código da simulação retornado em Simular.

period
integer<int32>

Quantidade de parcelas escolhida (Period de uma das opções simuladas).

description
string | null

Descrição/observação da proposta.

customer
object

Dados cadastrais do cliente enviados junto da contratação. Todo campo é opcional: o que vier preenchido sobrescreve o cadastro, o que vier vazio preserva o valor atual.

paymentMethod
integer<int32> | null

Forma de pagamento da proposta: 1 (conta bancária) ou 2 (chave PIX). Quando ausente, vale 1, o comportamento de sempre. O valor 2 só é aceito quando o pagamento por chave PIX está habilitado para a empresa; sem isso, a proposta é recusada. Qualquer outro valor é recusado. Com 2, o pagamento vai para a chave PIX cadastrada da loja; o parceiro não envia a chave. Se a loja não tiver chave PIX cadastrada, a proposta é recusada.

product
string | null

Descrição livre do produto financiado (por exemplo, o bem ou serviço vendido). Obrigatório quando a loja usa a análise de crédito automática; nas demais lojas é opcional.

Response

200

OK