View Categories

Finalize External Identification API

< 1 min read

Finalize External Identification #

Persists the final result after the identification/signing flow reports success and issues the correlation identifiers needed downstream.

Endpoint #

POST https://api-test.10npay.com/Enrollment/finalize-external-identification

Headers #

  • Authorization: Bearer <access_token>
  • Content-Type: application/json

Request Body #

{
  "userId": 2077,
  "bTrustAppCallBackId": null,
  "correlationType": 0
}
Field Description
userId User identifier. Required.
bTrustAppCallBackId Optional string supplied by the identification provider (use null if not applicable).
correlationType Optional context flag (default 0).

Response — 200 OK #

{
  "correlationId": "834d03b9-d24f-4d7b-950f-69aadff41599",
  "individualId": 989
}

Errors #

  • 400 Bad Request — the identification flow has not reached DOCUMENT_SIGN_SUCCESS yet.
  • 401 Unauthorized — missing/expired token.
  • 404 Not Found — unknown userId.
  • 5xx Server Error — retry with backoff.

Usage Notes #

  • Only call this after Phase B polling returns DOCUMENT_SIGN_SUCCESS.
  • The returned individualId should be stored for downstream CRM interactions.
  • If the call fails, keep retrying with the same payload until it succeeds (the operation is idempotent).