Consulta de Assinaturas da CCB

1. Consultar Link de Assinatura

Retorna os dados de assinatura vinculados a uma solicitação de crédito. Utilizado para obter o link de assinatura gerado pela plataforma ou verificar se a assinatura já foi concluída.

Endpoint

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

Authorization: Bearer {originator_access_token}

Exemplo de Requisição

curl --location 'https://sandbox.platform.flowfinance.com.br/banking/originator/applications/6a9e3c4a-da09-4f52-a495-416c900b97bd/signatures' \
--header 'Authorization: Bearer {originator_access_token}'

Exemplo de Resposta

[
  {
    "id": "25518dc4-344b-4150-bf20-a1ea72204a0b",
    "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/NGQwODVh...",
    "created_at": "2026-04-10T16:04:00.573281Z",
    "updated_at": "2026-04-10T16:05:13.68102Z",
    "version": 2,
    "external_id": null
  }
]

Descrição dos Campos da Resposta

Campo	Tipo	Descrição
`id`	string (UUID)	Identificador do registro de assinatura
`ip_address`	string	IP do dispositivo no momento da assinatura ou aceite de mandato
`user_agent`	string	User agent do app/navegador do tomador
`signed_at`	string (ISO 8601)	Timestamp da assinatura
`person.id`	string (UUID)	`person_id` do tomador
`person.full_name`	string	Nome completo do tomador
`person.taxpayer_id`	string	CPF do tomador
`collect_sign_link`	string	Link de assinatura gerado pela plataforma. Disponível quando `signature_collect_method` é `EMAIL`, `WHATSAPP` ou `LINK`
`version`	integer	Versão do registro (incrementa a cada atualização)
`external_id`	string \| null	Identificador externo no provedor de assinatura, quando aplicável

collect_sign_link: Nos fluxos de cláusula mandato (NONE) e envio de PDF (PHYSICAL), este campo pode estar ausente ou nulo, pois não há link de assinatura gerado pela plataforma.

2. Consultar Documentos Assinados (UNICO)

Após a conclusão bem-sucedida do processo de assinatura via UNICO, os documentos ficam disponíveis para consulta e auditoria, garantindo total rastreabilidade e conformidade legal da operação.

Os documentos disponíveis incluem:

CCB Assinada
Conjunto Probatório
Selfie
Foto do documento (CNH, RG etc.)

Endpoint

GET /banking/originator/applications/download

Authorization: Bearer {originator_access_token}

Query Parameters

Parâmetro	Tipo	Obrigatório	Descrição
`tipoDocumento`	string	Não	Tipo do documento de identificação utilizado na biometria. Ex: `CNH`, `RG`
`idsOperacoes`	string (UUID)	Não	ID da operação para filtrar documentos de uma CCB específica
`disbursementDateFrom`	string (YYYY-MM-DD)	Não	Data de desembolso inicial para filtro por período
`page`	integer	Não	Número da página para paginação dos resultados

Exemplo de Requisição

curl --location 'https://sandbox.platform.flowfinance.com.br/banking/originator/applications/download?tipoDocumento=CNH&idsOperacoes=ab371c06-729c-4f1f-bae7-7cd1274b5c2c&disbursementDateFrom=2025-10-08&page=20'

Exemplo de Resposta

{
  "content": [
    {
      "id": "ab371c06-729c-4f1f-bae7-7cd1274b5c2c",
      "CCB_ASSINADA": [
        {
          "type": "CNH",
          "url": "https://s3.sa-east-1.amazonaws.com/..."
        },
        {
          "type": "CONJUNTO_PROBATORIO",
          "url": "https://s3.sa-east-1.amazonaws.com/..."
        },
        {
          "type": "SELFIE",
          "url": "https://s3.sa-east-1.amazonaws.com/..."
        }
      ]
    }
  ]
}

Descrição dos Campos da Resposta

Campo	Tipo	Descrição
`content[].id`	string (UUID)	ID da operação (application_id)
`content[].CCB_ASSINADA`	array	Lista de documentos vinculados à CCB assinada
`CCB_ASSINADA[].type`	string	Tipo do documento: `CONJUNTO_PROBATORIO`, `SELFIE`, `CNH`, `RG` etc.
`CCB_ASSINADA[].url`	string	URL pré-assinada do documento no S3. Possui validade — utilize imediatamente após a consulta

URLs pré-assinadas: Os links retornados no campo url são temporários (pré-assinados via AWS S3). Faça o download ou exiba o documento imediatamente após a consulta — não armazene a URL para uso posterior.

Disponibilidade: Os documentos são disponibilizados apenas após a conclusão bem-sucedida do fluxo de assinatura UNICO. Consultas em operações com assinatura pendente não retornarão documentos.

Updated about 4 hours ago