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
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 |
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:
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 4 days ago