{"id":358,"date":"2025-09-09T16:28:46","date_gmt":"2025-09-09T16:28:46","guid":{"rendered":"https:\/\/developers.10npay.com\/?post_type=docs&p=1556"},"modified":"2026-05-21T14:38:35","modified_gmt":"2026-05-21T14:38:35","password":"","slug":"finalize-external-identification-api","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/finalize-external-identification-api\/","title":{"rendered":"Finalize External Identification API"},"content":{"rendered":"

Finalize External Identification<\/h1>\n

Persists the final result after the identification\/signing flow reports success and issues the correlation identifiers needed downstream.<\/p>\n

Endpoint<\/h2>\n
POST https:\/\/api-test.10npay.com\/Enrollment\/finalize-external-identification\n<\/code><\/pre>\n
Headers<\/h2>\n
    \n
  • Authorization: Bearer <access_token><\/code><\/li>\n
  • Content-Type: application\/json<\/code><\/li>\n<\/ul>\n
    Request Body<\/h2>\n
    {\n  \"userId\": 2077,\n  \"bTrustAppCallBackId\": null,\n  \"correlationType\": 0\n}\n<\/code><\/pre>\n\n\n\n\n\n\n\n
    Field<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    userId<\/code><\/td>\nUser identifier. Required.<\/td>\n<\/tr>\n
    bTrustAppCallBackId<\/code><\/td>\nOptional string supplied by the identification provider (use null<\/code> if not applicable).<\/td>\n<\/tr>\n
    correlationType<\/code><\/td>\nOptional context flag (default 0<\/code>).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Response — 200 OK<\/h2>\n
    {\n  \"correlationId\": \"834d03b9-d24f-4d7b-950f-69aadff41599\",\n  \"individualId\": 989\n}\n<\/code><\/pre>\n
    Errors<\/h2>\n
      \n
    • 400 Bad Request<\/strong> — the identification flow has not reached DOCUMENT_SIGN_SUCCESS<\/code> yet.<\/li>\n
    • 401 Unauthorized<\/strong> — missing\/expired token.<\/li>\n
    • 404 Not Found<\/strong> — unknown userId<\/code>.<\/li>\n
    • 5xx Server Error<\/strong> — retry with backoff.<\/li>\n<\/ul>\n
      Usage Notes<\/h2>\n
        \n
      • Only call this after Phase B polling returns DOCUMENT_SIGN_SUCCESS<\/code>.<\/li>\n
      • The returned individualId<\/code> should be stored for downstream CRM interactions.<\/li>\n
      • If the call fails, keep retrying with the same payload until it succeeds (the operation is idempotent).<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"
        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 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[58],"doc_tag":[],"knowledge_base":[33],"class_list":["post-358","docs","type-docs","status-publish","hentry","doc_category-web-identification","knowledge_base-10npay"],"year_month":"2026-05","word_count":153,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"10npaydev","author_nicename":"10npaydev","author_url":"https:\/\/developers.10npay.com\/bg\/author\/10npaydev\/"},"doc_category_info":[{"term_name":"Web identification","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/web-identification\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"10npay","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/","term_slug":"10npay"}],"knowledge_base_slug":["10npay"],"_links":{"self":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/358","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/comments?post=358"}],"version-history":[{"count":1,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/358\/revisions"}],"predecessor-version":[{"id":391,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/358\/revisions\/391"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=358"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=358"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=358"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=358"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}