Status de Solicitações (Applications)

Visão Geral

Uma solicitação (application) representa uma operação de crédito criada na plataforma. Após a criação, é possível acompanhar o seu status, consultar os detalhes e, quando necessário, cancelá-la.

Fluxo de Status

Fluxo padrão:

AGREEMENT_RENDERING → KYC_PROCESSING → PENDING_SIGNATURE → PENDING_DISBURSEMENT → ISSUED

Consignado com qualification:

AGREEMENT_RENDERING → KYC_PROCESSING → PENDING_SIGNATURE → PENDING_QUALIFICATION → PENDING_GUARANTEE → PENDING_DISBURSEMENT → ISSUED

Com cessão prévia (não se aplica ao Consignado):

 AGREEMENT_RENDERING → KYC_PROCESSING → PENDING_SIGNATURE → PENDING_CESSION_QUALIFICATION → PENDING_DISBURSEMENT → ISSUED

Com desembolso agendado (data futura):

... → PENDING_SIGNATURE → SCHEDULED_DISBURSEMENT → PENDING_DISBURSEMENT → ISSUED

Status Possíveis

1. Listar Solicitações

Retorna todas as solicitações do originador com paginação.

GET /banking/originator/applications

Authorization: Bearer {originator_access_token}

Exemplo de requisição:

curl --location 'https://sandbox.platform.flowfinance.com.br/banking/originator/applications' \
--header 'Authorization: Bearer {originator_access_token}'

Query Parameters opcionais:

2. Consultar Solicitação por ID

Retorna os detalhes completos de uma solicitação específica.

GET /banking/originator/applications/{application_id}

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' \
--header 'Authorization: Bearer {originator_access_token}'

Exemplo de resposta:

{
  "id": "6a9e3c4a-da09-4f52-a495-416c900b97bd",
  "status": "PENDING_SIGNATURE",
  "status_description": null,
  "product": {
    "id": "87a3767c-8d12-4164-80bf-5aa0ae796f06"
  },
  "borrower": {
    "id": "d43cb69e-aaad-4392-9781-ac441196175b"
  },
  "funding": {
    "id": "e746ba58-8cfe-48e0-872a-a4109baba935"
  },
  "simulation_id": "56ec99c0-04ea-4571-ba4f-3859c9b3cced",
  "balance_check_id": "be20ac27-a93c-41c9-9cdf-e3a92a13c49d",
  "signature_collect_method": "LINK",
  "signature_provider": "UNICO",
  "custom_variables": {
    "payment_day": "28"
  },
  "created_at": "2026-04-18T14:00:00Z",
  "updated_at": "2026-04-18T14:05:00Z",
  "version": 2
}

3. Cancelar Solicitação

Cancela uma solicitação existente. O cancelamento não é permitido quando a operação já está no status ISSUED.

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

Authorization: Bearer {originator_access_token}

Exemplo de requisição:

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

Retorno de sucesso: 200 OK — sem body.

Erro ao tentar cancelar operação já emitida:

{
  "message": "Application cannot be cancelled in its current status.",
  "is_retryable": false
}

Atenção: Uma vez no status ISSUED, o desembolso já foi realizado e a operação não pode ser cancelada via API. Nesse caso, entre em contato com o time da Celcoin.

Regras de Cancelamento