Biometria Dracma na abertura

Use este fluxo quando a verificação facial já aconteceu na Dracma. Você manda o id da verificação junto com o titular (PF) ou com cada sócio (PJ). A API lê essa verificação com a credencial Dracma do seu tenant e encerra a biometria nessa chamada.

Não há link de captura, página de aceite nem upload de selfie. O id precisa estar approved e com o mesmo CPF da pessoa. Cada id aprova uma abertura.

O tenant precisa de uma credencial Dracma ativa. Sem ela a criação responde 422 dracma_not_configured.

Fluxo

O objeto biometry

No person (PF) ou em cada item de partners (PJ). Todos no mesmo modo: Dracma não mistura com o fluxo padrão nem com outro provedor (422 mixed_biometry_mode).

"biometry": {
  "provider": "dracma",
  "evidenceId": "ver_01h..."
}

evidenceId é o id da verificação na Dracma, não um arquivo. provider aceito neste guia é só dracma.

curl -X POST "https://api.corpx.com/v1/accreditations/pf" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-Id: $TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "person": {
      "name": "Ana Silva",
      "cpf": "12345678909",
      "birthDate": "1990-01-15",
      "email": "ana@example.com",
      "phone": "+5511999998888",
      "biometry": { "provider": "dracma", "evidenceId": "ver_01hxyz" }
    },
    "address": {
      "zipCode": "01310100",
      "street": "Avenida Paulista",
      "number": "1000",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "cityIbgeCode": "3550308"
    }
  }'

A resposta 201 não traz biometryLink nem acceptanceLink. A pessoa já sai com a biometria aprovada.

• PF abre como no fluxo padrão: sem mesa, salvo a política de autoaprovação que o tenant já tiver.
• PJ fica em PENDING_REVIEW. Os PDFs societários obrigatórios continuam os de sempre.

A verificação só vale quando as três condições fecham:

• status approved (pending e review_required não aprovam);
• subject.cpf com os mesmos 11 dígitos da pessoa;
• esse id ainda não está preso a outra abertura que não tenha falhado.

Falha de rede na Dracma não aprova. A criação responde 503 dracma_unavailable e a abertura não fica viva.

Termo de abertura (opcional)

O PDF do termo não segura a conta. Envie quando quiser, em PF ou PJ, enquanto o status não for ACTIVE nem FAILED — inclusive depois da biometria, em INTEGRATING.

curl -X POST "https://api.corpx.com/v1/accreditations/$ACR_ID/documents" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-Id: $TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "account_opening_terms",
    "contentType": "application/pdf",
    "sizeBytes": 120034
  }'

Faça o PUT do PDF na uploadUrl que voltar. Esse kind não aparece em missingDocumentKinds.

Erros