Fluxo de Assinatura

A Unico é o provedor de assinatura digital utilizado para formalizar operações de crédito.
Nesta integração, a API permite:

  • Criar operações com a Unico como provedor de assinatura.
  • Consultar e disponibilizar o link de assinatura para os clientes.
  • Acompanhar o status da assinatura (aprovada, reprovada ou pendente).


1. Criação da Operação com a Unico

Para utilizar a Unico, é necessário informar na solicitação da operação os seguintes parâmetros:

  • O provedor de assinatura (signature_provider)
  • O tipo de fluxo de assinatura (signature_authentication_options)

Esses parâmetros devem ser enviados junto com os demais dados da solicitação.


POST /banking/originator/applications


Parâmetros da requisição

CampoTipoObrigatórioDescriçãoExemplo
signature_providerstringNãoDefine o provedor de assinatura. Usar valor "unico".UNICO
signature_authentication_optionsobjectNãoTipo de fluxo de assinatura da Unico (DOC_SIGN ou DOC_SIGN_SERPRO)DOC_SIGN

Caso não seja informado nenhum provedor, utilizaremos a assinatura interna da Celcoin como padrão.


Exemplo da requisição:

{
    "product": {
        "id": "baf74b04-ad57-4eb3-b02a-ce82aa78ecd8"
    },
    "borrower": {
        "id": "2cb09f0d-e7ea-454a-abd1-51d1fc129f89"
    },
    "funding": {
        "id": "9773c5fb-cbd7-41fa-b6b1-e9c76295259f"
    },
    "payment_method": "PIX",
    "simulation_id": "40f24e48-106a-4017-bba1-f3c5b22e22dc",
    "balance_check_id": "93752c1d-5620-4f51-842b-f48e44c73c82",
    "signature_provider": "UNICO",
    "signature_authentication_options": {"mode": "DOC_SIGN ou DOC_SIGN_SERPRO"}
}

Exemplo do response:

{
    "id": "d4e356de-40ee-4cff-8c44-acb4f8374387",
    "product": {
        "id": "0d4bee4a-5659-4e5c-b475-d7deafb19f7e"
    },
    "borrower": {
        "id": "2cb09f0d-e7ea-454a-abd1-51d1fc129f89"
    },
    "requested_amount": 1197.20,
    "interest_rate": 1.38E-4,
    "interest_pre_type": "BASE_365",
    "annual_interest_rate": 0.001652,
    "tac_amount": 0,
    "finance_fee": 50,
    "num_payments": 10,
    "first_payment_date": "2025-09-20",
    "disbursement_date": "2025-09-20",
    "allow_disbursement_on_sign": null,
    "issue_date": "2025-09-16",
    "status": "AGREEMENT_RENDERING",
    "cession_status": "NOT_CEDED",
    "status_description": null,
    "loan_details": {
        "total_processing_cost": 82.60,
        "annual_interest_rate": 0.020000,
        "interest_rate": 0.001652,
        "annual_effective_interest_rate": 0.047284,
        "monthly_effective_interest_rate": 0.003857,
        "total_amount_owed": 1350.00,
        "disbursement_amount": 1196.78,
        "discount_amount": 0,
        "discount_rate": 0.0,
        "financed_amount": 1246.78,
        "iof_daily_rate": 0.000082,
        "iof_amount": 32.60,
        "iof_base_rate": 0.0038,
        "payment_amount": 450.00,
        "issue_date": "2025-09-16",
        "schedule": [
            {
                "payment": 450.00,
                "iof": 7.63,
                "balance": 834.68,
                "interest": 5.29,
                "principal": 444.71,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 1,
                "running_day": 76,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2025-12-01"
            },
            {
                "payment": 270.00,
                "iof": 7.58,
                "balance": 581.38,
                "interest": 16.69,
                "principal": 253.31,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 2,
                "running_day": 365,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2026-12-01"
            },
            {
                "payment": 140.00,
                "iof": 3.84,
                "balance": 453.00,
                "interest": 11.63,
                "principal": 128.37,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 3,
                "running_day": 365,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2027-12-01"
            },
            {
                "payment": 70.00,
                "iof": 1.82,
                "balance": 392.09,
                "interest": 9.09,
                "principal": 60.91,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 4,
                "running_day": 366,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2028-12-01"
            },
            {
                "payment": 70.00,
                "iof": 1.86,
                "balance": 329.93,
                "interest": 7.84,
                "principal": 62.16,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 5,
                "running_day": 365,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2029-12-01"
            },
            {
                "payment": 70.00,
                "iof": 1.90,
                "balance": 266.53,
                "interest": 6.60,
                "principal": 63.40,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 6,
                "running_day": 365,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2030-12-01"
            },
            {
                "payment": 70.00,
                "iof": 1.94,
                "balance": 201.86,
                "interest": 5.33,
                "principal": 64.67,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 7,
                "running_day": 365,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2031-12-01"
            },
            {
                "payment": 70.00,
                "iof": 1.97,
                "balance": 135.91,
                "interest": 4.05,
                "principal": 65.95,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 8,
                "running_day": 366,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2032-12-01"
            },
            {
                "payment": 70.00,
                "iof": 2.01,
                "balance": 68.63,
                "interest": 2.72,
                "principal": 67.28,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 9,
                "running_day": 365,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2033-12-01"
            },
            {
                "payment": 70.00,
                "iof": 2.05,
                "balance": 0.00,
                "interest": 1.37,
                "principal": 68.63,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 10,
                "running_day": 365,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2034-12-01"
            }
        ],
        "last_payment_date": "2034-12-01",
        "reference_rate": null,
        "interest_pre_type": "BASE_365",
        "interest_rate_frequency": "ANNUALLY",
        "amortization_type": null,
        "interest_type": null,
        "grace_period_interest": null,
        "grace_period_amortizations": null,
        "amortization_frequency": null
    },
    "custom_variables": {},
    "canceled_at": null,
    "sequential_id": 1371,
    "funding": {
        "id": "9773c5fb-cbd7-41fa-b6b1-e9c76295259f",
        "legal_name": "developers funding",
        "alias": null,
        "metadata": {}
    },
    "payment_method": "PIX",
    "backoffice_import_status": "NONE",
    "guarantors": [],
    "co_signers": [],
    "investors": [],
    "co_debtors": [],
    "collateral_providers": [],
    "representatives": [],
    "sureties": [],
    "signature_collect_method": "NONE",
    "signature_provider": "UNICO",
    "issuer_disbursement_type": "BENEFICIARY",
    "signature_collect_options": {
        "require_self_photo": false,
        "require_document_photo": false,
        "require_selfie_validation": false
    },
    "base_premium_amount": 24.94,
    "additional_premium_amount": 0,
    "loan": null,
    "borrower_employer": null,
    "disbursement": null,
    "beneficiary_account": {
        "registered_account_id": null,
        "holder": {
            "name": "Rosa Alícia Martins",
            "taxpayer_id": "05974668316"
        },
        "external_bank_account": null,
        "pix": null,
        "baas": {
            "account_number": null
        }
    },
    "created_at": "2025-09-16T15:41:00.087828Z",
    "updated_at": "2025-09-16T15:41:00.114485Z",
    "version": 3,
    "cession_value": 1304.74,
    "issue_value": 1304.74,
    "issuer_migrated": false,
    "custodian": null,
    "signature_authentication_options": {
        "mode": "DOC_SIGN_SERPRO"
    },
    "managed_account_for_issuer_disbursement": {
        "product_configuration": null,
        "baas": null
    },
    "disbursement_attempts": [],
    "payment_orders": [],
    "ipoc_number": "48632754123451059746683161371",
    "additional_installment_fee": null,
    "additional_installment_description": null,
    "external_ccb_number": null,
    "annotation_id": null,
    "split_beneficiary_account": null,
    "entry_payment_info": null,
    "consignment": null,
    "contracts_to_purchase": [],
    "bundle_item_name": null
}



2.Consultar o link de assinatura

Após a criação da operação, é possível recuperar o link de assinatura.


GET: /originator/applications/{{id_solicitação}}/signatures


[
    {
        "id": "334c5e73-2e4b-4705-861d-23cda5066dab",
        "ip_address": "18.229.22.249",
        "user_agent": null,
        "signed_at": null,
        "person": {
            "id": "0c5894cb-e54d-409d-b442-8d88684b654d",
            "full_name": "Maria da Silva",
            "taxpayer_id": "12345678996"
        },
        "collect_sign_link": "https://cadastro.uat.unico.app/process/2fa698ca-07ae-4e03-9c9a-7b21b0d6a6aa",
        "created_at": "2025-09-18T18:19:55.633963Z",
        "updated_at": "2025-09-18T18:20:09.271364Z",
        "version": 1,
        "external_id": "a1009957-7f4a-4d22-b6e2-cc1f729d45ee"
    }
]

Observações

  • O campo collect_sign_link retorna a URL que deve ser aberta pelo cliente para realizar a assinatura.
  • O link é único e pode ser acessado diretamente em um Webview ou navegador.



3. Envio do Link para o assinante

No primeiro momento o cliente precisa expor o link de assinatura ao assinante no seu próprio fluxo.


🚧

Envio automático

A opção do envio automático do link ao assinante (via WhatsApp ou SMS diretamente pela plataforma) está em desenvolvimento e será disponibilizado em breve.


🕑

Validade do link de assinatura

O link permanecerá válido até as 23h59 da data de desembolso informada na solicitação da CCB.



4. Status da Assinatura

A assinatura pode resultar nos seguintes cenários:

StatusDescrição
Assinado + AprovadoO cliente concluiu a assinatura e a Unico validou com sucesso.O status da operação será atualizado para a próxima etapa
Assinado + ReprovadoO cliente assinou, mas a assinatura foi rejeitada por não passar em algum critérioO status da operação será atualizado para "cancelado" com o motivo "assinatura rejeitada"
Não AssinadaO cliente ainda não concluiu o processo de assinatura dentro do prazo de validadeO status da operação será atualizado para "cancelado" com o motivo "expirada"
Erro na assinaturaOcorreu algum erro inesperado no fluxo de assinaturaO status da operação será atualizado para "erro na assinatura" com possibilidade de retentar até as 23:59 da data de desembolso