Cadastro do Tomador e Emissão de CCB
👤Criação do Tomador
Após o tomador aceitar a proposta de crédito dentro do app da CTPS Digital, ele precisa informar dados
complementares para prosseguimento do fluxo de cadastro, etapa obrigatória para validação de
identidade (KYC) e emissão da CCB.
Esse fluxo pode ser conduzido de duas formas:
📝 1. Formulário Digital (Celcoin)
O tomador é direcionado para um formulário digital fornecido pela Celcoin, onde informará dados
complementares. Com essas informações, a plataforma realiza as análises de KYC para verificar se o
tomador está apto a seguir para a emissão da CCB.
⚙️ 2. Formulário do Originador (Cliente)
O tomador é direcionado para um fluxo personalizado dentro do ambiente do originador:
● O originador coleta os dados complementares
● Realiza a chamada via API para vincular a operação
● Realiza a chamada via API para criação do tomador
Documentação: vincular operação
POST: /banking/originator/workers-credit/apply/{{ id da proposta }}
JSON de Exemplo
{
"borrower_id": "40035787-a73e-4d50-9c40-c96c25dc3d0f",
"product_id": "8d6203bd-c228-4ef9-ac2b-c6d55a82d4ad",
"entry_url": "https://example.com/test",
"disbursement_date": "2025-06-12",
"funding_id": "9773c5fb-cbd7-41fa-b6b1-e9c76295259f",
"finance_fee": 0,
"first_payment_date": "2025-10-01",
"tac_amount": 0
}
{
"id": "bba3e04f-486a-45b7-b1f4-aa93c81d6c7f",
"product": {
"id": "8d6203bd-c228-4ef9-ac2b-c6d55a82d4ad"
},
"borrower": {
"id": "40035787-a73e-4d50-9c40-c96c25dc3d0f"
},
"requested_amount": 1200,
"interest_rate": 0.1,
"interest_pre_type": "BASE_360",
"annual_interest_rate": 2.138428,
"tac_amount": 0.0,
"finance_fee": 0.0,
"num_payments": 10,
"first_payment_date": "2025-10-01",
"disbursement_date": "2025-06-12",
"allow_disbursement_on_sign": null,
"issue_date": "2025-06-10",
"status": "AGREEMENT_RENDERING",
"cession_status": "NOT_CEDED",
"status_description": null,
"loan_details": {
"total_processing_cost": 27.14,
"annual_interest_rate": 2.138428,
"interest_rate": 0.100000,
"annual_effective_interest_rate": 2.253635,
"monthly_effective_interest_rate": 0.103310,
"total_amount_owed": 2596.40,
"disbursement_amount": 1200,
"discount_amount": 0,
"discount_rate": 0.0,
"financed_amount": 1227.14,
"iof_daily_rate": 0.000082,
"iof_amount": 27.14,
"iof_base_rate": 0.0038,
"payment_amount": 259.64,
"issue_date": "2025-06-10",
"schedule": [
{
"payment": 259.64,
"iof": 2.35,
"balance": 1227.20,
"interest": 77.16,
"principal": 182.48,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 1,
"running_day": 111,
"late_day": null,
"paid_value": null,
"payment_date": "2025-10-01"
},
{
"payment": 259.64,
"iof": 2.56,
"balance": 1044.72,
"interest": 93.75,
"principal": 165.89,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 2,
"running_day": 142,
"late_day": null,
"paid_value": null,
"payment_date": "2025-11-01"
},
{
"payment": 259.64,
"iof": 2.70,
"balance": 878.83,
"interest": 108.83,
"principal": 150.81,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 3,
"running_day": 172,
"late_day": null,
"paid_value": null,
"payment_date": "2025-12-01"
},
{
"payment": 259.64,
"iof": 2.80,
"balance": 728.02,
"interest": 122.54,
"principal": 137.10,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 4,
"running_day": 203,
"late_day": null,
"paid_value": null,
"payment_date": "2026-01-01"
},
{
"payment": 259.64,
"iof": 2.86,
"balance": 590.92,
"interest": 135.00,
"principal": 124.64,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 5,
"running_day": 234,
"late_day": null,
"paid_value": null,
"payment_date": "2026-02-01"
},
{
"payment": 259.64,
"iof": 2.86,
"balance": 466.28,
"interest": 146.33,
"principal": 113.31,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 6,
"running_day": 262,
"late_day": null,
"paid_value": null,
"payment_date": "2026-03-01"
},
{
"payment": 259.64,
"iof": 2.86,
"balance": 352.97,
"interest": 156.63,
"principal": 103.01,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 7,
"running_day": 293,
"late_day": null,
"paid_value": null,
"payment_date": "2026-04-01"
},
{
"payment": 259.64,
"iof": 2.84,
"balance": 249.96,
"interest": 166.00,
"principal": 93.64,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 8,
"running_day": 323,
"late_day": null,
"paid_value": null,
"payment_date": "2026-05-01"
},
{
"payment": 259.64,
"iof": 2.79,
"balance": 156.32,
"interest": 174.51,
"principal": 85.13,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 9,
"running_day": 354,
"late_day": null,
"paid_value": null,
"payment_date": "2026-06-01"
},
{
"payment": 259.64,
"iof": 2.52,
"balance": 71.19,
"interest": 188.45,
"principal": 71.19,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 10,
"running_day": 384,
"late_day": null,
"paid_value": null,
"payment_date": "2026-07-01"
}
],
"last_payment_date": "2026-07-01",
"reference_rate": null,
"interest_pre_type": "BASE_360",
"interest_rate_frequency": "MONTHLY",
"amortization_type": "PRICE",
"interest_type": "PRE",
"grace_period_interest": 0,
"grace_period_amortizations": [],
"amortization_frequency": "MONTHLY"
},
"custom_variables": {},
"canceled_at": null,
"sequential_id": 1209,
"funding": {
"id": "9773c5fb-cbd7-41fa-b6b1-e9c76295259f",
"legal_name": "developers funding",
"alias": null,
"metadata": {}
},
"payment_method": "BOLETO",
"backoffice_import_status": "NONE",
"guarantors": [],
"co_signers": [],
"investors": [],
"co_debtors": [],
"collateral_providers": [],
"representatives": [],
"sureties": [],
"signature_collect_method": "NONE",
"signature_provider": "CELCOIN",
"issuer_disbursement_type": "BENEFICIARY",
"signature_collect_options": {
"require_self_photo": false,
"require_document_photo": false,
"require_selfie_validation": false
},
"base_premium_amount": 14.73,
"additional_premium_amount": 0,
"loan": null,
"borrower_employer": null,
"disbursement": null,
"beneficiary_account": {
"registered_account_id": null,
"holder": {
"name": "John Fake Dooley",
"taxpayer_id": "65923430282"
},
"external_bank_account": {
"bank_code": "001",
"bank_account": "0028979",
"bank_account_digit": "2",
"bank_branch": "0001",
"bank_account_type": "CACC",
"ispb_code": "00000000"
},
"pix": {
"key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
"key_type": "ALEATORY_KEY"
},
"baas": {
"account_number": null
}
},
"created_at": "2025-06-10T14:56:17.469038Z",
"version": 0,
"cession_value": 1241.87,
"issue_value": 1241.87,
"issuer_migrated": false,
"custodian": null,
"signature_authentication_options": {
"mode": "NONE"
},
"managed_account_for_issuer_disbursement": {
"product_configuration": null,
"baas": null
},
"disbursement_attempts": [],
"payment_orders": [
{
"id": "f7ddad3a-caa6-42c4-b140-93ec89f66c94",
"amount": 1200,
"type": "PIX_OUT",
"status": "READY_FOR_PROCESSING",
"beneficiary_account": {
"registered_account_id": null,
"holder": {
"name": "John Fake Dooley",
"taxpayer_id": "65923430282"
},
"external_bank_account": {
"bank_code": "001",
"bank_account": "0028979",
"bank_account_digit": "2",
"bank_branch": "0001",
"bank_account_type": "CACC",
"ispb_code": "00000000"
},
"pix": {
"key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
"key_type": "ALEATORY_KEY"
},
"baas": {
"account_number": null
}
},
"beneficiary_type": "CONSIGNED",
"billet_info": null,
"allow_failure": null,
"qrcode_info": null,
"principal": null,
"is_partial_disbursement": null
}
],
"ipoc_number": "4863275406661659234302821209",
"additional_installment_fee": null,
"additional_installment_description": null,
"external_ccb_number": null,
"split_beneficiary_account": null,
"entry_payment_info": null
}
Documentação: Criação do tomador
https://developers.celcoin.com.br/reference/post_banking-originator-persons
Em ambos os fluxos, é executado o processo de KYC, essencial para garantir segurança e conformidade
regulatória. Esse processo pode seguir dois caminhos:
● Fluxo padrão da plataforma de crédito, com validações automatizadas e integradas;
● Fluxo personalizado do cliente, quando houver configurações específicas previamente definidas.
📄 Emissão da CCB
A emissão da CCB segue o fluxo padrão da plataforma, conforme já documentado.
Essa etapa inclui:
● Geração do contrato com os dados validados;
● Coleta das assinaturas digitais do tomador e, se aplicável, da instituição financeira;
● Averbação junto ao órgão responsável pelo consignado privado.
Somente após a conclusão dessas etapas é que o processo segue para o desembolso do crédito e, se
previsto, a cessão da operação.
Documentação:
https://developers.celcoin.com.br/reference/post_banking-originator-applications
❌ Cancelamento da CCB
O crédito consignado pode ser cancelado (desaverbado) em casos específicos, conforme as regras e
prazos estabelecidos pelo sistema. As situações que permitem o cancelamento incluem:
● Desistência pelo tomador: Solicitação de cancelamento dentro do prazo permitido.
● Cancelamento da CCB: Anulação formal do contrato, quando aplicável.
Documentação:
https://developers.celcoin.com.br/reference/post_banking-originator-applications-application-id-cancel
Updated 1 day ago