Pular para o conteúdo principal
Tipo: Assíncrona Após a assinatura da Cédula de Crédito Bancário (CCB) no passo anterior, o parceiro deve utilizar o endpoint de averbação para incluir a CCB assinada e os dados biométricos do trabalhador. Com a inclusão bem-sucedida da CCB assinada:
  • O contrato é averbado na DATAPREV;
  • A operação de crédito é liberada para a fila de pagamento.

Endpoint

POST /contrato/oferta-leilao/averbar-contrato

Pré-requisitos

  • CCB gerada com sucesso;
  • CCB devidamente assinada com biometria facial;
  • Token de autenticação válido.

Regras Técnicas Importantes

  • O payload enviado nesta requisição deve possuir tamanho inferior a 10 MB;
  • A inclusão da CCB assinada é obrigatória para a averbação do contrato;
  • A averbação ocorre de forma assíncrona, mediante integração da BMP com a DATAPREV.

Parâmetros da Requisição

CampoObrigatórioDescrição
contratoEmprestimoSimArquivo PDF da CCB assinada, codificado em Base64.
dataHoraAssinaturaSimData e hora da assinatura no formato dd-MM-yyyy HH:mm.
ipSimEndereço IP utilizado no momento da assinatura.
numeroContratoSimNúmero da CCB (mesmo valor retornado como numeroCCB no evento de geração da CCB).
registroBiometricoFacialSimArquivo JPG do registro biométrico facial, em Base64.
indicadorValidacaoComDocOficialSimIndica se a validação biométrica foi realizada com documento oficial.
latitudeNãoLatitude do local da assinatura.
longitudeNãoLongitude do local da assinatura.
dispositivoNãoIdentificação do dispositivo utilizado na assinatura.

Campos Condicionais — Validação com Documento Oficial

Quando indicadorValidacaoComDocOficial = true, os seguintes campos tornam-se obrigatórios:
  • documentoOficialComFotoFrente
  • documentoOficialComFotoVerso
  • tipoDocumento (1 = RG, 2 = CNH)
Quando indicadorValidacaoComDocOficial = false, os seguintes campos tornam-se obrigatórios:
  • baseBiometrica
  • score

Exemplo de Requisição

curl --request POST \
  --location 'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-leilao/averbar-contrato' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
    "contratoEmprestimo": "Arquivo PDF da CCB assinado em base64",
    "dataHoraAssinatura": "06-02-2025 15:00",
    "ip": "192.168.0.1",
    "numeroContrato": "5063297",
    "tipoDocumento": 1,
    "documentoOficialComFotoFrente": "Arquivo JPG frente em base64",
    "documentoOficialComFotoVerso": "Arquivo JPG verso em base64",
    "registroBiometricoFacial": "Arquivo JPG biometria em base64",
    "baseBiometrica": "SERPRO",
    "score": 98,
    "indicadorValidacaoComDocOficial": true,
    "latitude": -23.55052,
    "longitude": -46.633308,
    "dispositivo": "Android"
  }'

Comportamento Esperado

Após o envio da requisição:
  • A BMP inicia o processo de averbação junto à DATAPREV;
  • O parceiro deve aguardar o callback de Averbação de Empréstimo;
  • Em caso de sucesso, a operação segue para liberação de pagamento.

Considerações Técnicas

  • Falhas na biometria, inconsistências documentais ou problemas de competência podem resultar em rejeição da averbação;
  • Todo o acompanhamento do processo deve ser realizado por meio de callbacks