{"id":5693,"date":"2025-08-05T15:17:54","date_gmt":"2025-08-05T13:17:54","guid":{"rendered":"https:\/\/support.neocheck.com\/?post_type=knowledgebase&p=5693"},"modified":"2025-10-21T15:13:38","modified_gmt":"2025-10-21T13:13:38","slug":"integracion","status":"publish","type":"knowledgebase","link":"https:\/\/support.neocheck.com\/en\/help\/kyb\/v-2-5\/integracion\/","title":{"rendered":"Integration"},"content":{"rendered":"

The first thing we need to consider is the exact needs of the project before jumping into programming. Please take a look at the article \u00abHow to Integrate NeoCheck<\/a>\u00ab.<\/p>\n\n\n\n

That said, NeoCheck provides an intuitive and powerful REST JSON API to integrate KYB (Know Your Business) and AML (Anti-Money Laundering) compliant verifications into your business or application. This API reference provides information about the available endpoints and how to interact with them.<\/p>\n\n\n\n

For detailed technical specifications, please visit our Swagger portal: https:\/\/kyb.neocheck.net\/Swagger\/index.html<\/a><\/p>\n\n\n\n

API Authentication<\/h3>\n\n\n\n

Access to the NeoCheck API is protected using OAuth2 authorization tokens. To authenticate your requests, you must call the authentication request with valid username and password credentials provided by the NeoCheck team. The endpoint for authentication is: \/api\/authorization\/token<\/p>\n\n\n\n

Note: The apiKey and apiSecret parameters are obsolete. Simply leave them empty as their content is ignored and only retained for backward compatibility.<\/strong><\/p>\n\n\n\n

Gesti\u00f3n de Configuraciones<\/h3>\n\n\n\n

Luego de la autenticaci\u00f3n se debe buscar la configuraci\u00f3n con la cual se va a realizar la verificaci\u00f3n. Para esto se pueden utilizar dos endpoints distintos:<\/p>\n\n\n\n

Note: For all endpoints from this point onward, the following parameters must be set in the Headers<\/strong>. Authorization<\/strong>, you must include the token obtained in the previous authentication request. Example: Bearer YOUR_ACCESS_TOKEN. Content-Type<\/strong>, you must set the corresponding content type, application\/json.<\/p>\n\n\n\n

    \n
  • \/api\/v1\/kyb\/companies\/lookup<\/code>\n
      \n
    • This GET method is used to find the available companies according to the following filters as query parameters:\n
        \n
      • companyName<\/strong>: El nombre de la configuraci\u00f3n<\/li>\n\n\n\n
      • vatNumber<\/strong>: The company\u2019s VAT number<\/li>\n\n\n\n
      • country<\/strong>: The company\u2019s country of registration<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • The method returns a list in the form of an array containing the matching companies.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • \/api\/v1\/kyb\/companies\/{id}<\/code>\n
          \n
        • This GET method is used to obtain the KYB verification company using the provider identifier as a path parameter.<\/li>\n\n\n\n
        • It returns the KYB verification company corresponding to the identifier passed as a parameter.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n

          KYB Verification Management<\/h3>\n\n\n\n

          Once the information of the corresponding company is obtained, a call must be made to the POST \/api\/v1\/kyb\/verifications endpoint in order to create the KYB verification.<\/p>\n\n\n\n

          In the body<\/strong>, configure the following parameters:<\/p>\n\n\n\n

            \n
          • companyProviderIdentifier<\/strong>: (String)\n
              \n
            • Description: Company ID provided by the provider.<\/li>\n\n\n\n
            • Example: \u00abA12345678\u00bb<\/li>\n<\/ul>\n<\/li>\n\n\n\n
            • manualCompanyData<\/strong>: (Object)\n
                \n
              • Description: Object containing the company\u2019s data.<\/li>\n\n\n\n
              • Example:<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
                {\n    \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"providerIdentifier\": \"string\",\n    \"businessName\": \"string\",\n    \"businessRegNumber\": \"string\",\n    \"vatNumber\": \"string\",\n    \"dateOfRegistration\": \"2025-08-06T13:14:06.612Z\",\n    \"address\": {\n      \"addressLine1\": \"string\",\n      \"addressLine2\": \"string\",\n      \"postalCode\": \"string\",\n      \"locality\": \"string\",\n      \"province\": \"string\",\n      \"country\": \"string\",\n      \"currentAddress\": true\n    }<\/code><\/pre>\n\n\n\n
                  \n
                • kybVerificationId<\/strong>: (Guid)\n
                    \n
                  • Description: KYB verification ID.<\/li>\n\n\n\n
                  • Example: \u00ab00000000-0000-0000-0000-000000000000<\/code>\u00bb<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                  • applicantId<\/strong>: (Guid)\n
                      \n
                    • Description: applicant's ID.<\/li>\n\n\n\n
                    • Example: \u00ab00000000-0000-0000-0000-000000000000<\/code>\u00bb<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                    • notificationApiUrl<\/strong>: (String)\n
                        \n
                      • Description: URL to which verification status notifications will be sent.<\/li>\n\n\n\n
                      • Example: \"https:\/\/example.com\/api\/notifications\"<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                      • kybVerificationTicket<\/strong>: (Object)\n
                          \n
                        • Description: Object in which the ticket and applicant data are added, such as name, email address, phone number, language, and whether the link will be sent directly to the applicant via email.<\/li>\n\n\n\n
                        • Example: <\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
                          {\n    \"name\": \"string\",\n    \"emailAddress\": \"string\",\n    \"phoneNumber\": \"string\",\n    \"language\": \"string\",\n    \"sendLink\": true\n  }<\/code><\/pre>\n\n\n\n
                          Full Body Example<\/h4>\n\n\n\n
                          {\n  \"companyProviderIdentifier\": \"string\",\n  \"manualCompanyData\": {\n    \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"providerIdentifier\": \"string\",\n    \"businessName\": \"string\",\n    \"businessRegNumber\": \"string\",\n    \"vatNumber\": \"string\",\n    \"dateOfRegistration\": \"2025-08-06T13:14:06.612Z\",\n    \"address\": {\n      \"addressLine1\": \"string\",\n      \"addressLine2\": \"string\",\n      \"postalCode\": \"string\",\n      \"locality\": \"string\",\n      \"province\": \"string\",\n      \"country\": \"string\",\n      \"currentAddress\": true\n    },\n    \"kybVerificationId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n  },\n  \"applicantId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"notificationApiUrl\": \"string\",\n  \"kybVerificationTicket\": {\n    \"name\": \"string\",\n    \"emailAddress\": \"string\",\n    \"phoneNumber\": \"string\",\n    \"language\": \"string\",\n    \"sendLink\": true\n  }\n}<\/code><\/pre>\n\n\n\n
                          This endpoint will return a string as a response, which corresponds to the verification ID.<\/p>\n\n\n\n
                          Obtain the link manually<\/h3>\n\n\n\n
                          If you want to obtain the ticket link manually, you can make a call to the following endpoint: \/api\/v1\/kyb\/verifications\/{id}\/ticket\/link, where the id is the verification ID obtained in the previous step. <\/p>\n\n\n\n
                          It will return a string corresponding to the ticket URL for the applicant.<\/p>\n\n\n\n
                          Error Handling<\/h4>\n\n\n\n
                          Neocheck API returns standard HTTP status codes to indicate the success or failure of a request. Here are some common examples:<\/p>\n\n\n\n
                            \n
                          • 200 OK<\/strong>: The request was successful.<\/li>\n\n\n\n
                          • 401 Unauthorized<\/strong>: Authentication failed or the API key is invalid. Review the token being used for the request.<\/li>\n\n\n\n
                          • 404 Not Found<\/strong>: The requested resource was not found. Please check the endpoint you are targeting.<\/li>\n\n\n\n
                          • 500 Internal Server Error<\/strong>: Internal system failure.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"
                            Lo primero que debemos plantearnos es qu\u00e9 necesidades exactas tiene el proyecto antes de lanzarnos a programar. Por favor echa un vistazo al art\u00edculo \u00abC\u00f3mo integrar NeoCheck\u00ab. Dicho esto, NeoCheck proporciona una API REST JSON intuitiva y poderosa para integrar verificaciones conformes con KYB (Know Your Business) y AML (Anti Money Laundering) en tu negocio  […]<\/p>\n","protected":false},"author":51,"featured_media":0,"comment_status":"open","ping_status":"open","template":"","knowledgebase_cat":[397],"class_list":["post-5693","knowledgebase","type-knowledgebase","status-publish","hentry","knowledgebase_cat-v-2-5"],"_links":{"self":[{"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/knowledgebase\/5693","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/types\/knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/users\/51"}],"replies":[{"embeddable":true,"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/comments?post=5693"}],"version-history":[{"count":0,"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/knowledgebase\/5693\/revisions"}],"wp:attachment":[{"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/media?parent=5693"}],"wp:term":[{"taxonomy":"knowledgebase_cat","embeddable":true,"href":"https:\/\/support.neocheck.com\/en\/wp-json\/wp\/v2\/knowledgebase_cat?post=5693"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}