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
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 |
|
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.