Updated: 23 June 2023

InsentarJurosEInserirPromessaPagamento - Promessa com desconto para contrato Credits (à vista)

Insere uma promessa de pagamento com desconto, utilizando o valor de desconto obtido através do método ListarMontantePerdoar, caso ele não trouxer o valor do desconto, então utilize este outro método: InserirPromessaPagamentoZerada.

Essa promessa de pagamento engloba o valor completo da dívida vencida, que inclui empréstimos e cartão (quando houver), então é um caso para quitação total da dívida vencida do cliente.

Não é possível inserir uma promessa nova caso já exista outra vigente (consulte o campo "vigentes" no artigo PesquisarCliente)

Obs: Este método não serve para cobrar contratos do tipo Cross Meli, para esses, use o outro método 

InserirPromessaPagamentoZerada

Request:

Endpoint: /v1/engage/InsentarJurosEInserirPromessaPagamento

Método: POST

Parametros via Body:

{
  "documento": "string",
  "usuarioLogin": {
    "user": "string",
    "password": "string"
  }, 
  "MontanteComDesconto": 0,
  "valorDesconto": 0,
  "canalPagamento": "string",
  "dataPagamento": "yyyy-MM-d",
  "telefone": "string",
  "gravarTelefone": true,
  "observacao": "string"
}


Legenda dos parâmetros:

parâmetro tipo descrição

documento

string

Cpf do cliente a ser pesquisado

usuarioLogin.user

string

Usuário do site Engage do MercadoPago

usuarioLogin.password

string

Senha do usuário do site Engage do MercadoPago

MontanteComDesconto

decimal

(opcional) Valor do montante a ser pago, com desconto já subtraído dele (Default: null ou zero = será calculado automaticamente pelo Engage o valor da divida vencida da gestão credits, com o desconto aplicado)(mais detalhes abaixo)

valorDesconto

decimal

valor do desconto para abater da divida vencida (obtido no metodo de ListarMontantePerdoar )

canalPagamento

string

Metodo de pagamento. Obs: Opções: "Dinheiro", "Boleto", "Loterica", "Pix"

dataPagamento

DateTime

Data de pagamento da promessa

telefone

string

Telefone do cliente

gravarTelefone

boolean

(opcional) true= Grava telefone do cliente no site Engage. false= não grava

observacao

string

Texto para ser gravado na ocorrência no site do Engage


Exemplo de uso do campo "MontanteComDesconto":

Se o cliente deve R$1500 e você vai dar R$500 de desconto pra ele, então o cliente vai pagar R$1000 .

Na chamada da Api os dois parâmetros de valores ficariam assim:

montanteComDesconto : 1000.00
valorDesconto : 500.00

Obs: se o campo "MontanteComDesconto" for deixado nulo ou zerado, a Api usará o cálculo oferecido pelo Engage, ou seja, vai somar tudo o que refere a gestão CREDITS (empréstimos, cartão de crédito e afins), então caso desejar cobrar apenas o valor dos empréstimos sem somar o cartão de crédito junto, o uso desse campo é recomendado.


Response:

Caso inserir a promessa com sucesso, o RESPONSE retornárá como OK (status 200) e com um booleano 'true'.

Caso não inserir a promessa, retornará como status Bad Request e uma mensagem de texto em string.