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
| Campo | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| signature_provider | string | Não | Define o provedor de assinatura. Usar valor "unico". | UNICO |
| signature_authentication_options | object | Não | Tipo de fluxo de assinatura da Unico (DOC_SIGN ou DOC_SIGN_SERPRO) | DOC_SIGN |
| signature_collect_method | object | Não | Canal de envio do link de assinatura (WHATSAPP, SMS ou LINK) |
- 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:
| Status | Descrição | |
|---|---|---|
| Assinado + Aprovado | O cliente concluiu a assinatura e a Unico validou com sucesso. | O status da operação será atualizado para a próxima etapa |
| Assinado + Reprovado | O cliente assinou, mas a assinatura foi rejeitada por não passar em algum critério | O status da operação será atualizado para "cancelado" com o motivo "assinatura rejeitada" |
| Não Assinada | O cliente ainda não concluiu o processo de assinatura dentro do prazo de validade | O status da operação será atualizado para "cancelado" com o motivo "expirada" |
| Erro na assinatura | Ocorreu algum erro inesperado no fluxo de assinatura | O status da operação será atualizado para "erro na assinatura" com possibilidade de retentar até as 23:59 da data de desembolso |
Updated 13 days ago