Skip to main content

Negociação de Parcelas Vencidas

Este fluxo descreve a negociação de parcelas vencidas de um contrato, iniciada pelo nosso sistema. O objetivo é consolidar cobranças em atraso em uma nova negociação parcelada.
Após o processamento, o parceiro deve enviar o webhook INSERTED_FINANCIAL_NEGOCIATION.

🔁 Visão Geral do Fluxo​

  1. Nosso sistema envia a requisição NEGOTIATION para a API do parceiro com os dados da negociação.
  2. A API do parceiro processa a negociação.
  3. O parceiro envia o webhook INSERTED_FINANCIAL_NEGOCIATION com os dados da nova cobrança.

📤 Requisição enviada pelo nosso sistema (para o parceiro)​

Endpoint (API do parceiro): definido pelo parceiro.

Payload:

{
  "contract_id": 1001,
  "partner_pay_subscription_id": 2001,
  "event": "NEGOTIATION",
  "data": {
    "financials": [
      { "partner_pay_id": "pp_abc123" },
      { "partner_pay_id": "pp_def456" }
    ],
    "form_of_payment": "credit_card",
    "method": "in_sight",
    "installment": 3,
    "value": 1500.75,
    "first_pay_day_date": "2025-08-01"
  }
}

✅ Regras da solicitação​

  • Os partner_pay_id informados devem estar vencidos ou em aberto.
  • O valor total (value) deve representar a soma ou condição renegociada das parcelas.
  • A nova cobrança será enviada via webhook como parcelamento.

📥 Webhook de retorno esperado​

Webhook INSERTED_FINANCIAL_NEGOCIATION​

Enviado com os dados da nova cobrança parcelada. 🔗 Veja a documentação do webhook INSERTED_FINANCIAL_NEGOCIATION

📋 Exemplo do fluxo completo​

🧪 Considerações técnicas​

  • O parceiro deve garantir o envio do webhook após o processamento.
  • O webhook deve conter os dados consolidados da negociação (parcelamento).
  • Reentregar o webhook caso o status de resposta não seja 2xx.

🔄 Resposta esperada do webhook​

{
  "success": true
}