{"id":355,"date":"2025-09-09T13:45:35","date_gmt":"2025-09-09T13:45:35","guid":{"rendered":"https:\/\/developers.10npay.com\/?post_type=docs&p=1545"},"modified":"2026-05-21T14:18:08","modified_gmt":"2026-05-21T14:18:08","password":"","slug":"user-add-additional-data-2","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/user-add-additional-data-2\/","title":{"rendered":"User \u2014 Add Additional Data"},"content":{"rendered":"

User \u2013 Add Additional Data<\/h1>\n

Submits the extended KYC\/Risk questionnaire collected from the user (source of funds, account purpose, addresses, geolocation, etc.). This call is mandatory before triggering external identification.<\/p>\n

Endpoint<\/h2>\n
POST https:\/\/api-test.10npay.com\/User\/add-additional-data\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  \"id\": 2077,\n  \"additionalData\": {\n    \"type\": \"EnrollAdditionalData\",\n    \"data\": {\n      \"userId\": 2077,\n      \"BTrustAppCallBackId\": \"\",\n      \"isCorrespondenceAddressSame\": true,\n      \"sourceOfFundId\": \"8\",\n      \"residenceAddressZipCode\": \"1000\",\n      \"correspondenceAddress\": {\n        \"addressLine\": \"\",\n        \"city\": \"\",\n        \"stateProvinceCounty\": \"\",\n        \"zipCode\": \"\",\n        \"countryId\": \"BG\"\n      },\n      \"secondaryLanguage\": \"BUL\",\n      \"taxResidences\": \"BG\",\n      \"gender\": \"M\",\n      \"accountPurposeCode\": \"1\",\n      \"mainActivityCode\": \"1\",\n      \"financingMethodCode\": \"2\",\n      \"enrollIP\": \"203.0.113.24\",\n      \"enrollLatitude\": 42.6975,\n      \"enrollLongitude\": 23.3241,\n      \"enrollChannel\": \"M\"\n    }\n  }\n}\n<\/code><\/pre>\n
    Field Reference<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n
    Field<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    id<\/code>, additionalData.data.userId<\/code><\/td>\nUser identifier (keep both in sync). Required.<\/td>\n<\/tr>\n
    additionalData.type<\/code><\/td>\nContract marker. Use \"EnrollAdditionalData\"<\/code>.<\/td>\n<\/tr>\n
    BTrustAppCallBackId<\/code><\/td>\nOptional string from the later identification callback.<\/td>\n<\/tr>\n
    isCorrespondenceAddressSame<\/code><\/td>\nIf false<\/code>, populate correspondenceAddress<\/code> with full details.<\/td>\n<\/tr>\n
    sourceOfFundId<\/code>, accountPurposeCode<\/code>, mainActivityCode<\/code>, financingMethodCode<\/code><\/td>\nCodes retrieved from GET \/User\/source-of-funds<\/code>, \/account-purpose<\/code>, \/main-activity<\/code>, \/financing-method<\/code>.<\/td>\n<\/tr>\n
    secondaryLanguage<\/code>, taxResidences<\/code>, gender<\/code><\/td>\nStrings (ISO codes \/ policy-supported values).<\/td>\n<\/tr>\n
    residenceAddressZipCode<\/code><\/td>\nPostal code (validated via GET \/User\/{zip}\/{country}\/postal-code-by-country<\/code>).<\/td>\n<\/tr>\n
    enrollIP<\/code>, enrollLatitude<\/code>, enrollLongitude<\/code>, enrollChannel<\/code><\/td>\nDevice\/geolocation metadata captured at enrollment time.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Responses<\/h2>\n
      \n
    • 200 OK<\/strong> — data stored successfully.<\/li>\n
    • 400 Bad Request<\/strong> — validation failure (missing codes, invalid postal data, etc.).<\/li>\n
    • 401 Unauthorized<\/strong> — missing\/expired Bearer token.<\/li>\n
    • 404 Not Found<\/strong> — unknown user.<\/li>\n
    • 5xx Server Error<\/strong> — transient backend issue.<\/li>\n<\/ul>\n
      Notes<\/h2>\n
        \n
      • Call the lookup endpoints first to populate dropdowns (Account Purpose, Source of Funds, Main Activity, Financing Method, Countries).<\/li>\n
      • When isCorrespondenceAddressSame = false<\/code>, every field under correspondenceAddress<\/code> becomes mandatory.<\/li>\n
      • Ensure you capture the user\u2019s IP and geolocation once (e.g., via the mobile SDK) and include them here.<\/li>\n
      • This step must succeed before invoking any identification endpoints.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"
        User \u2013 Add Additional Data Submits the extended KYC\/Risk questionnaire collected from the user (source of funds, account purpose, addresses, geolocation, etc.). This call is mandatory before triggering external identification. Endpoint POST https:\/\/api-test.10npay.com\/User\/add-additional-data Headers Authorization: Bearer <access_token> Content-Type: application\/json Request Body { “id”: 2077, “additionalData”: { “type”: “EnrollAdditionalData”, “data”: { “userId”: 2077, “BTrustAppCallBackId”: “”, “isCorrespondenceAddressSame”: […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[55],"doc_tag":[],"knowledge_base":[33],"class_list":["post-355","docs","type-docs","status-publish","hentry","doc_category-create-customer","knowledge_base-10npay"],"year_month":"2026-05","word_count":253,"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":"Create - Customer","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/create-customer\/"}],"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\/355","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=355"}],"version-history":[{"count":1,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/355\/revisions"}],"predecessor-version":[{"id":388,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/355\/revisions\/388"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=355"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=355"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=355"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=355"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}