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)
  • O canal de envio do link de assinatura (signature_collect_method)

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
signature_collect_methodobjectNãoCanal de envio do link de assinatura (WHATSAPP, SMS ou LINK)WHATSAPP
  • Caso não seja informado nenhum provedor, utilizaremos a assinatura interna da Celcoin como padrão.
  • Caso não seja informado o canal de envio do link, o sistema irá apenas gerar o link de assinatura e não fará o envio para o tomador.

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"}
    "signature_collect_method": {"WHATSAPP, SMS ou LINK"}
}

Exemplo do response:

{
    "id": "8defbd26-fcce-4d81-91ae-8f8f8c623097",
    "product": {
        "id": "9ceda7fd-f1b6-47d8-a8bd-ae37dc4f5bb8"
    },
    "borrower": {
        "id": "104e9a5f-01bb-41f2-a0c7-d0a40c73d041"
    },
    "requested_amount": 1,
    "interest_rate": 0.01,
    "interest_pre_type": "BASE_360",
    "annual_interest_rate": 0.126825,
    "tac_amount": 0,
    "finance_fee": 0,
    "num_payments": 1,
    "first_payment_date": "2025-11-11",
    "disbursement_date": "2025-10-11",
    "allow_disbursement_on_sign": null,
    "issue_date": "2025-10-11",
    "status": "AGREEMENT_RENDERING",
    "cession_status": "NOT_CEDED",
    "status_description": null,
    "loan_details": {
        "total_processing_cost": 0.00,
        "annual_interest_rate": 0.126825,
        "interest_rate": 0.010000,
        "annual_effective_interest_rate": 0.122493,
        "monthly_effective_interest_rate": 0.009676,
        "total_amount_owed": 1.01,
        "disbursement_amount": 1.00,
        "discount_amount": 0,
        "discount_rate": 0.0,
        "financed_amount": 1.00,
        "iof_daily_rate": 0.000082,
        "iof_amount": 0.00,
        "iof_base_rate": 0.0038,
        "payment_amount": 1.01,
        "issue_date": "2025-10-11",
        "schedule": [
            {
                "payment": 1.01,
                "iof": 0.00,
                "balance": 1.00,
                "interest": 0.01,
                "principal": 1.00,
                "additional_value": 0.00,
                "present_value": null,
                "status": null,
                "period": 1,
                "running_day": 31,
                "late_day": null,
                "paid_value": null,
                "payment_date": "2025-11-11"
            }
        ],
        "last_payment_date": "2025-11-11",
        "reference_rate": null,
        "interest_pre_type": "BASE_360",
        "interest_rate_frequency": "MONTHLY",
        "amortization_type": null,
        "interest_type": null,
        "grace_period_interest": null,
        "grace_period_amortizations": null,
        "amortization_frequency": null,
        "insurance_amount": 0
    },
    "custom_variables": {},
    "canceled_at": null,
    "sequential_id": 2474006,
    "funding": {
        "id": "836acb37-5d45-4963-930c-ba506aa76114",
        "legal_name": "TESTA EM PROD SECURITIZADORA",
        "alias": null,
        "metadata": {
            "cod_backoffice": {
                "value": "",
                "sensitive": false
            }
        }
    },
    "payment_method": "BOLETO",
    "backoffice_import_status": "NONE",
    "guarantors": [],
    "co_signers": [],
    "investors": [],
    "co_debtors": [],
    "collateral_providers": [],
    "representatives": [],
    "sureties": [],
    "signature_collect_method": "LINK",
    "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": 0.01,
    "additional_premium_amount": 0,
    "loan": null,
    "borrower_employer": null,
    "disbursement": null,
    "beneficiary_account": {
        "registered_account_id": null,
        "holder": {
            "name": "Viviane da Silva Reis",
            "taxpayer_id": "39268966808"
        },
        "external_bank_account": {
            "bank_code": "001",
            "bank_account": "0005150",
            "bank_account_digit": "6",
            "bank_branch": "4616",
            "bank_account_type": "CACC",
            "ispb_code": "00000000"
        },
        "pix": {
            "key": "39268966808",
            "key_type": "TAXPAYER_ID"
        },
        "baas": {
            "account_number": null
        }
    },
    "created_at": "2025-10-11T19:10:41.849639Z",
    "version": 0,
    "cession_value": 1.01,
    "issue_value": 1.01,
    "issuer_migrated": true,
    "custodian": null,
    "signature_authentication_options": {
        "mode": "DOC_SIGN"
    },
    "managed_account_for_issuer_disbursement": {
        "product_configuration": null,
        "baas": null
    },
    "disbursement_attempts": [],
    "payment_orders": [
        {
            "id": "42810cd0-4139-4149-bd12-f8dea060c615",
            "amount": 1.00,
            "type": "PIX_OUT",
            "status": "READY_FOR_PROCESSING",
            "beneficiary_account": {
                "registered_account_id": null,
                "holder": {
                    "name": "Viviane da Silva Reis",
                    "taxpayer_id": "39268966808"
                },
                "external_bank_account": {
                    "bank_code": "001",
                    "bank_account": "0005150",
                    "bank_account_digit": "6",
                    "bank_branch": "4616",
                    "bank_account_type": "CACC",
                    "ispb_code": "00000000"
                },
                "pix": {
                    "key": "39268966808",
                    "key_type": "TAXPAYER_ID"
                },
                "baas": {
                    "account_number": null
                }
            },
            "beneficiary_type": "BORROWER",
            "billet_info": null,
            "allow_failure": null,
            "qrcode_info": null,
            "principal": null,
            "is_partial_disbursement": null,
            "pay_application_id": null
        }
    ],
    "ipoc_number": "4863275402031392689668082474006",
    "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,
    "insurance_amount": 0,
    "if_code": null,
    "cccb_code": null
}

Caso a operação seja realizada via Portal de Crédito, o sistema irá apresentar a opção para o originador selecionar o provedor de assinatura, o tipo de assinatura e como ele deseja enviar o link.




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 deve ser acessado por um aparelho mobile.
  • O link permanecerá válido até as 23h59 da data de desembolso informada na solicitação da CCB.



3. 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