Assinatura via Cláusula Mandato (Timestamp)

Visão Geral

Na cláusula mandato, o originador assina a CCB em nome do tomador com base em uma autorização prévia concedida pelo próprio tomador. Esse modelo elimina a necessidade de envio de link ou notificação ao tomador no momento da assinatura.

Para utilizar este fluxo, a solicitação de crédito deve ser criada com signature_collect_method: "NONE" e provider: CELCOIN`, indicando que não haverá coleta de assinatura por canal externo (e-mail, WhatsApp ou link).

Pré-requisito: Criar a Solicitação com NONE

Na criação da CCB, defina signature_collect_method como NONE para habilitar o fluxo de mandato:

{
  "product": { "id": "PRODUCT_ID" },
  "borrower": { "id": "BORROWER_ID" },
  "funding": { "id": "FUNDING_ID" },
 "simulation_id":"UIID",
  "first_payment_date": "2025-MM-DD",
  "disbursement_date": "2025-MM-DD",
  "signature_collect_method": "NONE",
"signature_provider": "CELCOIN"
}

Endpoint

POST /banking/originator/applications/{application_id}/signatures

Authorization: Bearer {originator_access_token}

Payload

{
  "ip_address": "192.168.1.15",
  "signed_at": "2024-07-26T14:53:58.590Z",
  "user_agent": "CFNetwork/1.0 Darwin/23.5.0 (iPhone iOS/17.5.1) [email protected]+12761-PROD",
  "person": {
    "id": "BORROWER_PERSON_ID"
  }
}

Descrição dos Campos

Resposta de Sucesso

{
  "id": "450c37af-61cc-4181-9447-ca6fe9324932",
  "ip_address": "192.168.1.15",
  "user_agent": "CFNetwork/1.0 Darwin/23.5.0 (iPhone iOS/17.5.1) [email protected]+12761-PROD",
  "signed_at": "2024-07-26T14:53:58.59Z",
  "person": {
    "id": "50a2cfd2-f73d-46de-b51a-bb446ca0bdbb",
    "full_name": "Carlos Pereira",
    "taxpayer_id": "70824635965"
  },
  "collect_sign_link": "https://sandbox.signer.flowfinance.com.br/...",
  "created_at": "2026-04-09T14:11:00.634679Z",
  "updated_at": "2026-04-09T14:13:56.999687Z"
}

Fluxo Completo

1. Tomador aceita a cláusula mandato no app do originador
       ↓
2. Originador captura: ip_address, user_agent, timestamp
       ↓
3. POST /applications/{id}/signatures com os dados de aceite
       ↓
4. Plataforma registra a assinatura e avança o status da CCB
       ↓
5. CCB segue para desembolso normalmente

Observações Importantes

Responsabilidade do originador: Os dados de ip_address, user_agent e signed_at devem refletir com fidelidade o momento real em que o tomador aceitou os termos da cláusula mandato no app. Esses dados têm valor jurídico e compõem o registro de auditoria da operação.

person.id: Deve ser o person_id do tomador previamente cadastrado na plataforma. Não é o CPF.

signature_collect_method: NONE: Obrigatório na criação da solicitação para habilitar este fluxo. Se a solicitação foi criada com outro método (EMAIL, WHATSAPP, LINK), o envio de timestamp será rejeitado.