Originação com pagamento ao tomador

Visão Geral

Fluxo padrão de originação de CCB onde o valor desembolsado é direcionado integralmente ao tomador.

Endpoint

POST /banking/originator/applications

Payload Completo

{
  "product": {
    "id": "{{productId}}"
  },
  "borrower": {
    "id": "{{borrowerId}}"
  },
  "funding": {
    "id": "{{fundingId}}"
  },
  "simulation_id": "{{simulationId}}",,
  "signature_provider": "ZAPSIGN",
  "signature_collect_method": "LINK",
  "signature_authentication_options": {
    "mode": "FACIAL_BIOMETRICS"
  },
  "signature_collect_options": {
    "require_selfie_validation": true
  }
}

Referência de Campos

Campos raiz

Campo	Tipo	Obrigatório	Descrição
`product.id`	uuid	sim	ID do produto configurado
`borrower.id`	uuid	sim	ID do tomador cadastrado
`funding.id`	uuid	sim	ID do fundo/originador
`simulation_id`	uuid	sim	Retornado pelo endpoint `/preview`. Vincula os dados da simulação à application
`signature_provider`	enum	sim	Provedor de assinatura. Ver tabela de provedores abaixo
`signature_collect_method`	enum	sim	Método de envio do link de assinatura. Ver tabela de provedores abaixo
`signature_authentication_options`	object	não	Configurações de autenticação no momento da assinatura
`signature_collect_options`	object	não	Configurações adicionais do processo de coleta de assinatura

Objeto `signature_authentication_options`

Campo	Tipo	Obrigatório	Descrição
`mode`	enum	não	Modo de autenticação do signatário. `FACIAL_BIOMETRICS` \| `NONE`

Quando mode: FACIAL_BIOMETRICS, o signatário é obrigado a realizar reconhecimento facial durante o processo de assinatura. Disponível apenas para provedores que suportam biometria — confirmar compatibilidade por produto.

Objeto `signature_collect_options`

Campo	Tipo	Obrigatório	Descrição
`require_selfie_validation`	boolean	não	Quando `true`, exige que o signatário envie uma selfie como etapa de validação durante a assinatura

require_selfie_validation: true é recomendado em conjunto com mode: FACIAL_BIOMETRICS para reforço de identidade. Pode ser usado de forma independente conforme política do produto.

Provedores de Assinatura

`signature_provider`	`signature_collect_method` compatível	Observação
`ZAPSIGN`	`LINK` \| `WHATSAPP` \| `EMAIL`	Recomendado para fluxos digitais
`CELCOIN`	`LINK` \| `WHATSAPP` \| `EMAIL`	Verificar disponibilidade por produto
`UNICO`	`LINK` \| `WHATSAPP` \| `SMS`	Validação biométrica — não suporta EMAIL
`CLICKSIGN`	`LINK` \| `WHATSAPP` \| `EMAIL`	Suporte completo a métodos digitais

Observações Importantes

simulation_id — gerado pelo endpoint /preview. Expira após um período configurado no produto. Sempre crie a application logo após a simulação para evitar expiração.

Biometria facial — o uso de FACIAL_BIOMETRICS + require_selfie_validation: true eleva o nível de segurança da assinatura e pode ser exigido por alguns produtos CLT. Verificar se o provedor selecionado suporta ambas as opções em conjunto.

Erros Comuns

Situação	Causa provável
`simulation_id` expirado	Tempo entre simulação e criação excedeu o limite configurado no produto
Erro de autenticação biométrica	Provedor selecionado não suporta `FACIAL_BIOMETRICS` para o produto
`signature_collect_method` inválido	Método incompatível com o `signature_provider` selecionado — ver tabela de provedores