Assinatura via Envio de PDF

Visão Geral

Neste fluxo, o tomador assina a CCB fora da plataforma — seja por assinatura física, por um sistema próprio do originador, ou por qualquer outro meio externo. O originador é responsável por coletar o documento assinado e enviá-lo à Celcoin via upload de PDF.

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

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

A combinação signature_collect_method: NONE + signature_provider: CELCOIN indica que nenhum link de assinatura será gerado pela plataforma — o documento assinado será entregue pelo originador posteriormente.

Endpoint

POST /banking/originator/applications/{application_id}/physical-signature

Authorization: Bearer {originator_access_token}
Content-Type: multipart/form-data

Payload

Fluxo Completo

1. Originador cria a solicitação com signature_collect_method: NONE + signature_provider: CELCOIN
       ↓
2. Plataforma gera a CCB em PDF (disponível para download)
       ↓
3. Tomador assina o documento fora da plataforma
       ↓
4. Originador recebe o PDF assinado e faz upload
       ↓
POST /applications/{id}/physical-signature (multipart/form-data)
       ↓
5. Celcoin valida o documento e avança o status da CCB
       ↓
6. CCB segue para desembolso normalmente

Observações Importantes

Qualidade do PDF: O documento enviado deve ser legível e conter a assinatura visível do tomador. PDFs corrompidos ou ilegíveis podem causar rejeição manual na validação.

Baixar a CCB para assinatura: Antes do upload, o originador deve baixar o PDF gerado pela plataforma via GET /banking/originator/applications/{application_id}/ccb. Este é o documento oficial que deve ser assinado e reenviado.