Flows and Sequence Diagram

Sequence Diagram

KYB Sequence Diagram - Part 1KYB Sequence Diagram - Part 1

KYB Sequence Diagram - Part 1

KYB Sequence Diagram - Part 2KYB Sequence Diagram - Part 2

KYB Sequence Diagram - Part 2

Explanation of steps

  1. Search for Company: /data/v2/businesses?search=(name | abn | acn)
    1. The following endpoint can be used to search a company using it’s name.
      1. https://apidocs.frankiefinancial.com/docs/business-look-up
      2. As a response you will get a list of companies that match your criteria
    2. If you enter an ABN then you only get the one company with it basic details.
    3. This step is optional and only required if you don’t have the companies ABN/ ACN to query Single Level or UBO report
    4. Request ASIC or UBO report: /business/ownership/query
  2. The following endpoint can be used to generate an ASIC or UBO report.
    1. https://api.kycaml.frankiefinancial.io/compliance/v1.2/business/ownership/query
  3. Use the following Query Parameters for generating the UBO Report
    1. onlyProfile=false
    2. generateReport=UBO
    3. checkType=pep_media This will ensure we are doing AML checks on categories listed in entityCategories
    4. entityCategories=organisation,officers_directors,direct_owners,ubos AML checks will be performed on these categories of entity from the UBO report.
    5. resultLevel=full This will ensure the detailed level of result is sent back which contains the AML verification results
    6. Use the following Query Parameters for generating an ASIC extract
      1. onlyProfile=true
      2. generateReport=SINGLE-LEVEL-AML
      3. entityCategories=organisation
      4. resultLevel=full This will ensure the detailed level of result is sent back which contains the AML verification results
    7. Using this endpoint you can also request verification of UBO/ officeholder by adding checkType query param. This is purely optional and depends on your organisation’s use case. Endpoint mentioned in step 3 is specifically for verifying individuals and organisations that the report is generated for.
    8. It is important to note that this is an asynchronous call and you will never receive a report as the response of /business/ownership/query. As a response to this request you will only receive a requestId and entityId. You will need to keep track of these values to fetch the report. Refer to Asynchronous Calls (Backgrounding Processes) for more details on async calls.
    9. You have the option to configure a webhook so Frankie will notify you once the report is ready.
  4. Retrieve API Response: https://apidocs.frankiefinancial.com/reference#retrieve
  5. Run KYC/ AML checks: https://apidocs.frankiefinancial.com/reference#checkorganisation
    1. If KYC/ AML checks were not run as part of report generation (Step 2). You can run them as part of this step.
    2. Set the following Query Parameters to verify the individuals and/ or organisation
      1. entityCategories
      2. checkType
      3. Once the AML/KYC results are ready you will receive a web-hook notification and you can retrieve the results then (Step 3)

Conditions

When requesting a UBO report using the following endpoint:
POST /business​/ownership​/query, depending on the organisation type and company structure then Frankie shall only perform the checks based on the organisation type data returned from creditor watch.

Frankie will determine if the organisation is suitable for an ownership query based on if an ACN is provided or through credit checks.

  • As a sole trader would not usually be registered with ASIC unless operating under a different trading name and would not generate any reports.
  • A proprietary limited company with a simple organisation structure with only direct owners would result in a ASIC report being generated.
  • A complex company structure with multiple levels of ownership would result in a UBO report being generated.

Example

POST /business/ownership/query
{
    "X-Frankie-CustomerID": <X-Frankie-CustopmerID>,
    "X-Frankie-Channel": "api",
    "checkType": [
        "profile": <Recipe>,    
    ],
    "entityCategories": [
        all
    ],
    "resultLevel": "full",
    "validation": "on",
    "generateReport": "UBO",
    "query":
    {
        "organisation":
        {
            "registries": {
                "abn": <abn>
            }
        }
    }   
}

Helpful Postman Files


Did this page help you?