SG request examples

To onboard your entity, you can call the Onboard Corporate Customer API. For an example call that you can customize with your information, see:

Private companies

The following is an API request example call where businessType = PRIVATE_COMPANY.

{
    "region": "SG",
    "businessDetails": {
        "referenceId": "6913aac9-cbd9-4783-8fd6-07ea9655dfec",
        "businessName": "Singapore Electronics",
        "businessRegistrationNumber": "903287324",
		"website":"www.singaporeelectronics.com",
        "businessType": "PRIVATE_COMPANY",
        "legalDetails": {
            "registeredCountry": "SG",
            "registeredDate": "2000-01-02"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "High Street 101, 56th Avenue",
                "addressLine2": "Hyung County",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "documentDetails": [
            {
                "documentType": "BUSINESS_REGISTRATION_DOC",
                "document": [
                    {
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                        "fileName": "BRD.pdf",
                        "fileType": "application/pdf"
                    }
                ]
            }
        ],
        "stakeholders": [
            {
                "referenceId": "d25c5c6f-d4b0-47a5-986e-7b50641b65fc",
                "stakeholderDetails": {
                    "firstName": "Narendra",
                    "middleName": "C",
                    "lastName": "Bhargav",
                    "nationality": "IN",
                    "kycMode": "MANUAL_KYC",
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR"
                        },
                        {
                            "position": "UBO"
                        }
                    ],
                    "address": {
                        "addressLine1": "7 Ang Mo Kio Street",
                        "addressLine2": "64 No.01-01",
                        "city": "Singapore",
                        "country": "SG",
                        "postcode": "28046"
                    },
                    "documentDetails": [
                        {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "IN",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }
                    ]
                }
            },
            {
                "referenceId": "006ebeeb-3ede-4f49-8381-1e382334131c",
                "businessPartner": {
                    "legalDetails": {
                        "registeredCountry": "FR"
                    },
                    "businessEntityType": "SHAREHOLDER",
                    "businessName": "Farto AgriTECH LIMITED",
                    "businessRegistrationNumber": "822843822"
                }
            }
        ],
        "applicantDetails": {
            "referenceId": "0c61376b-70c3-4d45-9193-0a6ddece4e0e",
            "firstName": "Hardik",
            "middleName": "Kumar",
            "lastName": "Roshan",
            "dateOfBirth": "1982-07-17",
            "nationality": "SG",
            "kycMode": "E_KYC",
            "contactDetails": {
                "contactNo": "222268870",
                "countryCode": "SG",
                "email": "[email protected]"
            },
            "professionalDetails": [
                {
                    "position": "SIGNATORY"
                }
            ],
            "address": {
                "addressLine1": "7 Ang Mo Kio Street",
                "addressLine2": "64 No.01-01",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes",
            "searchId": "6nf3aac9-cbd9-423k-8fd6-07ea9345dfec"
        }
    },
    "riskAssessmentInfo": {
        "countryOfOperation": [
            "HK",
            "IN"
        ],
        "transactionCountries": [
            "GB",
            "AU",
            "FR"
        ],
       
      "totalEmployees": "EM009",
        "annualTurnover": "SG011",
        "industrySector": "IS144",
        "intendedUseOfAccount": "IU003"
    },
    "tags": [
        {
            "key": "tag1",
            "value": "tag1value"
        },
        {
            "key": "tag2",
            "value": "tag2value"
        }
    ]
}

Public companies

The following is an API request example call where businessType = PUBLIC_COMPANY.

{
    "region": "SG",
    "businessDetails": {
        "referenceId": "6913aac9-cbd9-4783-8fd6-07ea9655dfec",
        "businessName": "Singapore Special Appliances",
        "businessRegistrationNumber": "903280424",
		"website":"www.singaporeappliances.com",
        "businessType": "PUBLIC_COMPANY",
        "legalDetails": {
            "registeredCountry": "SG",
            "registeredDate": "2000-01-02",
            "listedExchange": "EX080"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "High Street 101, 56th Avenue",
                "addressLine2": "Hyung County",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "documentDetails": [
            {
                "documentType": "BUSINESS_REGISTRATION_DOC",
                "document": [
                    {
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                        "fileName": "BRD.pdf",
                        "fileType": "application/pdf"
                    }
                ]
            }
        ],
        "stakeholders": [
            {
                "referenceId": "d25c5c6f-d4b0-47a5-986e-7b50641b65fc",
                "stakeholderDetails": {
                    "firstName": "John",
                    "middleName": "C",
                    "lastName": "Grisham",
                    "nationality": "IN",
                    "kycMode": "MANUAL_KYC",
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR"
                        },
                        {
                            "position": "UBO",
                            "sharePercentage": "60"
                        }
                    ],
                    "address": {
                        "addressLine1": "7 Ang Mo Kio Street",
                        "addressLine2": "64 No.01-01",
                        "city": "Singapore",
                        "country": "SG",
                        "postcode": "28046"
                    },
                    "documentDetails": [
                        {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "IN",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }
                    ]
                }
            },
            {
                "referenceId": "006ebeeb-3ede-4f49-8381-1e382334131c",
                "businessPartner": {
                    "legalDetails": {
                        "registeredCountry": "FR"
                    },
                    "businessEntityType": "SHAREHOLDER",
                    "businessName": "Fiago AgriTECH LIMITED",
                    "businessRegistrationNumber": "822843822"
                }
            }
        ],
        "applicantDetails": {
            "referenceId": "0c61376b-70c3-4d45-9193-0a6ddece4e0e",
            "firstName": "Mitchell",
            "middleName": "",
            "lastName": "Johnson",
            "dateOfBirth": "1982-07-17",
            "nationality": "SG",
            "kycMode": "E_KYC",
            "contactDetails": {
                "contactNo": "222268870",
                "countryCode": "SG",
                "email": "[email protected]"
            },
            "professionalDetails": [
                {
                    "position": "SIGNATORY"
                }
            ],
            "address": {
                "addressLine1": "7 Ang Mo Kio Street",
                "addressLine2": "64 No.01-01",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes",
            "searchId": "6nf3aac9-cbd9-423k-8fd6-07ea9345dfec"
        }
    },
    "riskAssessmentInfo": {
        "countryOfOperation": [
            "HK",
            "IN"
        ],
        "transactionCountries": [
            "GB",
            "AU",
            "FR"
        ],
        "totalEmployees": "EM009",
        "annualTurnover": "SG011",
        "industrySector": "IS144",
        "intendedUseOfAccount": "IU003"
    },
    "tags": [
        {
            "key": "tag1",
            "value": "tag1value"
        },
        {
            "key": "tag2",
            "value": "tag2value"
        }
    ]
}

Partnerships

The following is an API request example call where businessType = PARTNERSHIP.

{
    "region": "SG",
    "businessDetails": {
        "referenceId": "6913aac9-cbd9-4783-8fd6-07ea9655dfec",
        "businessName": "S&K Partners",
        "businessRegistrationNumber": "903272424",
		"website":"www.snkpartners.com",
        "businessType": "PARTNERSHIP",
        "legalDetails": {
            "registeredCountry": "SG",
            "registeredDate": "2000-01-02"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "High Street 101, 56th Avenue",
                "addressLine2": "Hyung County",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "documentDetails": [
            {
                "documentType": "PARTNERSHIP_DEED",
                "document": [
                    {
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                        "fileName": "PARTNERSHIPDeed.pdf",
                        "fileType": "application/pdf"
                    }
                ]
            }
        ],
        "stakeholders": [
            {
                "referenceId": "d25c5c6f-d4b0-47a5-986e-7b50641b65fc",
                "stakeholderDetails": {
                    "firstName": "Samuel",
                    "middleName": "C",
                    "lastName": "Dickenson",
                    "nationality": "US",
                    "kycMode": "MANUAL_KYC",
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR"
                        },
                        {
                            "position": "UBO"
                        }
                    ],
                    "address": {
                        "addressLine1": "7 Ang Mo Kio Street",
                        "addressLine2": "64 No.01-01",
                        "city": "Singapore",
                        "country": "SG",
                        "postcode": "28046"
                    },
                    "documentDetails": [
                        {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }
                    ]
                }
            },
            {
                "referenceId": "006ebeeb-3ede-4f49-8381-1e382334131c",
                "businessPartner": {
                    "legalDetails": {
                        "registeredCountry": "FR"
                    },
                    "businessEntityType": "SHAREHOLDER",
                    "businessName": "Soso FINTECH LIMITED",
                    "businessRegistrationNumber": "FL22843822"
                }
            }
        ],
        "applicantDetails": {
            "referenceId": "0c61376b-70c3-4d45-9193-0a6ddece4e0e",
            "firstName": "Katrina",
            "middleName": "",
            "lastName": "Kaif",
            "dateOfBirth": "1982-07-17",
            "nationality": "SG",
            "kycMode": "E_KYC",
            "contactDetails": {
                "contactNo": "222268870",
                "countryCode": "SG",
                "email": "[email protected]"
            },
            "professionalDetails": [
                {
                    "position": "SIGNATORY"
                }
            ],
            "address": {
                "addressLine1": "7 Ang Mo Kio Street",
                "addressLine2": "64 No.01-01",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes",
            "searchId": "6nf3aac9-cbd9-423k-8fd6-07ea9345dfec"
        }
    },
    "riskAssessmentInfo": {
        "countryOfOperation": [
            "HK",
            "IN"
        ],
        "transactionCountries": [
            "GB",
            "AU",
            "FR"
        ],
        "totalEmployees": "EM009",
        "annualTurnover": "SG011",
        "industrySector": "IS144",
        "intendedUseOfAccount": "IU003"
    },
    "tags": [
        {
            "key": "tag1",
            "value": "tag1value"
        },
        {
            "key": "tag2",
            "value": "tag2value"
        }
    ]
}

Simulate scenarios in the eKYB flow

If you are using eKYB flow for the Singapore region, you can generate the following scenarios by using the below steps with the example businessRegistrationNumber (BRN) in the following table.

Simulated scenarioConditionsExample BRN
Approved applicationBRN contains M01 and stakeholderDetails.firstName starts with AA for all individual stakeholders with kycMode = MANUAL_KYCBRN: M01324536, 234M01456, 12M01B325; Stakeholder firstName: AAshutosh, AAnthony
Action requiredBRN contains A02A02324536, 234A02456, 12A02B325
In progress with documents requiredBRN contains A03A03324536, 234A03456, 12A03B325
Completing applicant eKYCPattern on applicantDetails.contactDetails.contactNo
Completing applicant eDocVerifyPattern on applicantDetails.contactDetails.contactNo

Step 1: Call the Public Corporate Details Using Business ID API using the Business Registration Number and Region according to the scenario you want to test. You receive multiple businesses in the response. Pick the one with with matching businessRegistrationNumber and copy the searchReferenceId.

In this response, the businessName is always returned as STAR FINANCE PRIVATE LIMITED appended by your businessRegistrationNumber and doesn't match with what is returned in Step 2. This behavior is only in the sandbox; the accurate name appears in production.

Step 2: Call the Exhaustive Corporate Details Using Business ID API using the searchReferenceId received in Step 1 for the particular scenario. This returns detailed information about the corporate customer including searchId.

Step 3: Use the any of the sample requests in this page and call the Onboard Corporate Customer API.

Step 5: Use the redirect URL and complete the Applicant KYC section on the MyInfo page (or use the simulated scenarios for KYC mentioned below) and wait for the webhook. Verification can be completed with dummy credentials if using Myinfo's sandbox. Regardless, you need to open the redirect URL in your browser.

Response conditions for the Exhaustive Corporate Details API

You can generate responses for different businessType by following the table below. This can be used for testing the pre-population flow after calling the Exhaustive Corporate Details Using Business ID API.

businessTypeCondition on businessRegistrationNumber
PUBLIC_COMPANYContains A01 or A02 or A03
PRIVATE_COMPANYContains A11 or A12 or A13
SOLE_TRADERContains A21 or A22 or A23
PARTNERSHIPContains A31 or A32 or A33

Request example: approved application

For the description of this scenario, see approved application scenario

{
    "region": "SG",
    "businessDetails": {
        "businessName": "ACME COMPANY PTE. LTD. PWUIMRBF",
        "businessRegistrationNumber": "M01232393",
        "businessType": "PUBLIC_COMPANY",
        "legalDetails": {
            "registeredCountry": "SG",
            "registeredDate": "2021-07-13",
            "listedExchange": "EX056"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "22 CIRCULAR ROAD , 02 - 01",
                "addressLine2": "-",
                "city": "SINGAPORE",
                "state": "SINGAPORE",
                "country": "SG",
                "postcode": "049422"
            }
        },
        "stakeholders": [
            {
                "stakeholderDetails": {
                    "firstName": "AANISHA",
                    "middleName": null,
                    "lastName": "XUCCH",
                    "nationality": "IN",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "A - 2/5, CHANDER PRIYA APARTMENT, SECTOR -9, NEAR GANESH MRI",
                        "addressLine2": "ROHINI, NORTH WEST DELHI",
                        "city": "ROHINI",
                        "state": "NEW DELHI",
                        "country": "IN",
                        "postcode": "110085"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "UBO",
                            "sharePercentage": "27"
                        },
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                  
                },
                "businessPartner": null
            },
            {
                "stakeholderDetails": {
                    "firstName": "TANISHA",
                    "middleName": null,
                    "lastName": "FLEZY",
                    "nationality": "IN",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "A - 2/5, CHANDER PRIYA APARTMENT, SECTOR -9, NEAR GANESH MRI",
                        "addressLine2": "ROHINI, NORTH WEST DELHI",
                        "city": "ROHINI",
                        "state": "NEW DELHI",
                        "country": "IN",
                        "postcode": "110085"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "SHAREHOLDER",
                            "sharePercentage": "5"
                        }
                    ],
                    "documentDetails": null
                },
                "businessPartner": null
            },
            {
                "stakeholderDetails": {
                    "firstName": "AANANYA",
                    "middleName": null,
                    "lastName": "SHKZREB",
                    "nationality": "SG",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "39 ROBINSON ROAD",
                        "addressLine2": "11-01,ROBINSON POINT",
                        "city": "SINGAPORE",
                        "state": "SINGAPORE",
                        "country": "SG",
                        "postcode": "068911"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                },
                "businessPartner": null
            }
        ],
        "applicantDetails": {
                    "firstName": "TEO",
                    "middleName": null,
                    "lastName": "SHfOCCF",
                    "nationality": "SG",
                    "dateOfBirth": "1989-10-10",
                    "kycMode": "E_KYC",
                    "address": {
                        "addressLine1": "15 ST. GEORGE'S ROAD",
                        "addressLine2": "05-166",
                        "city": "SINGAPORE",
                        "state": "SINGAPORE",
                        "country": "SG",
                        "postcode": "32015"
                    },
                    "contactDetails": {
                        "contactNo": "32423411",
                        "countryCode": "SG",
                        "email": "[email protected]"
                    },
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": null
                },
        "additionalInfo": {
            "searchId": "2ea658b7-6ce3-4f2b-b22d-dab0b1ea0abb",
            "isSameBusinessAddress": "yes"
        }
    },
    "riskAssessmentInfo": {
        "totalEmployees": "EM009",
        "annualTurnover": "SG011",
        "industrySector": "IS144",
        "intendedUseOfAccount": "IU003",
        "countryOfOperation": [
            "SG",
            "US",
            "GB"
        ],
        "transactionCountry": [
            "DE",
            "JP",
            "IN"
        ]
    }
}

Request example: action required

For the description of this scenario, see Action required scenario

{
    "region": "SG",
    "businessDetails": {
        "businessName": "ACME COMPANY PTE. LTD. PWUIMRBF",
        "businessRegistrationNumber": "A11232393",
        "businessType": "PUBLIC_COMPANY",
        "legalDetails": {
            "registeredCountry": "SG",
            "registeredDate": "2021-07-13",
            "listedExchange": "EX056"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "22 CIRCULAR ROAD , 02 - 01",
                "addressLine2": "-",
                "city": "SINGAPORE",
                "state": "SINGAPORE",
                "country": "SG",
                "postcode": "049422"
            }
        },
        "stakeholders": [
            {
                "stakeholderDetails": {
                    "firstName": "MANISHA",
                    "middleName": null,
                    "lastName": "XUCCH",
                    "nationality": "IN",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "A - 2/5, CHANDER PRIYA APARTMENT, SECTOR -9, NEAR GANESH MRI",
                        "addressLine2": "ROHINI, NORTH WEST DELHI",
                        "city": "ROHINI",
                        "state": "NEW DELHI",
                        "country": "IN",
                        "postcode": "110085"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "UBO",
                            "sharePercentage": "27"
                        },
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                },
                "businessPartner": null
            },
            {
                "stakeholderDetails": {
                    "firstName": "TANISHA",
                    "middleName": null,
                    "lastName": "FLEZY",
                    "nationality": "IN",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "A - 2/5, CHANDER PRIYA APARTMENT, SECTOR -9, NEAR GANESH MRI",
                        "addressLine2": "ROHINI, NORTH WEST DELHI",
                        "city": "ROHINI",
                        "state": "NEW DELHI",
                        "country": "IN",
                        "postcode": "110085"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "SHAREHOLDER",
                            "sharePercentage": "5"
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                },
                "businessPartner": null
            },
            {
                "stakeholderDetails": {
                    "firstName": "TANYA",
                    "middleName": null,
                    "lastName": "SHKZREB",
                    "nationality": "SG",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "39 ROBINSON ROAD",
                        "addressLine2": "11-01,ROBINSON POINT",
                        "city": "SINGAPORE",
                        "state": "SINGAPORE",
                        "country": "SG",
                        "postcode": "068911"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                },
                "businessPartner": null
            }
        ],
        "applicantDetails": {
                    "firstName": "TEO",
                    "middleName": null,
                    "lastName": "SHfOCCF",
                    "nationality": "SG",
                    "dateOfBirth": "1989-10-10",
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "15 ST. GEORGE'S ROAD",
                        "addressLine2": "05-166",
                        "city": "SINGAPORE",
                        "state": "SINGAPORE",
                        "country": "SG",
                        "postcode": "32015"
                    },
                    "contactDetails": {
                        "contactNo": "32423411",
                        "countryCode": "SG",
                        "email": "[email protected]"
                    },
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": null
                },
        "additionalInfo": {
            "searchId": "2ea658b7-6ce3-4f2b-b22d-dab0b1ea0abb",
            "isSameBusinessAddress": "yes"
        }
    },
    "riskAssessmentInfo": {
        "totalEmployees": "EM009",
        "annualTurnover": "SG011",
        "industrySector": "IS144",
        "intendedUseOfAccount": "IU003",
        "countryOfOperation": [
            "SG",
            "US",
            "GB"
        ],
        "transactionCountry": [
            "DE",
            "JP",
            "IN"
        ]
    }
}

Request example: in progress with documents required

For the description of this scenario, see In progress scenario

{
    "region": "SG",
    "businessDetails": {
        "businessName": "ACME COMPANY PTE. LTD. 8083",
        "businessRegistrationNumber": "A0183473323",
        "businessType": "PRIVATE_COMPANY",
        "legalDetails": {
            "registeredCountry": "SG",
            "registeredDate": "2017-07-08"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "67 HIGH STREET, 06-08",
                "addressLine2": "SATNAM HOUSE",
                "city": "SINGAPORE",
                "state": "SINGAPORE",
                "country": "SG",
                "postcode": "179431"
            }
        },
        "stakeholders": [
            {
                "entityType": "CORPORATE",
                "stakeholderDetails": null,
                "businessPartner": {
                    "businessName": "TANYA SH VKP",
                    "businessRegistrationNumber": "E6554322",
                    "businessEntityType": "Shareholder",
                    "addresses": {
                        "registeredAddress": {
                            "addressLine1": "2 PANDAN VALLEY",
                            "addressLine2": "02-212, ACACIA COURT",
                            "city": "SINGAPORE",
                            "state": "SINGAPORE",
                            "country": "SG",
                            "postcode": "079903"
                        }
                    },
                    "legalDetails": {
                        "registeredCountry": "SG"
                    }
                }
            },
            {
                "entityType": "INDIVIDUAL",
                "stakeholderDetails": {
                    "firstName": "ROBERT",
                    "middleName": "SH",
                    "lastName": "UWW",
                    "nationality": "VG",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "85 JLN DEDAP 7 TAMAN JAYA",
                        "addressLine2": "JOHOR BAHRU, JOHOR",
                        "city": "MALAYSIA",
                        "state": "MALAYSIA",
                        "country": "MY",
                        "postcode": "81100"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "UBO",
                            "sharePercentage": "52.4"
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                },
                "businessPartner": null
            },
            {
                "entityType": "INDIVIDUAL",
                "stakeholderDetails": {
                    "firstName": "PETER",
                    "middleName": null,
                    "lastName": "TQ",
                    "nationality": "MN",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "85 JLN DEDAP 7 TAMAN JAYA",
                        "addressLine2": "JOHOR BAHRU, JOHOR",
                        "city": "MALAYSIA",
                        "state": "MALAYSIA",
                        "country": "MY",
                        "postcode": "81100"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                },
                "businessPartner": null
            },
            {
                "entityType": "INDIVIDUAL",
                "stakeholderDetails": {
                    "firstName": "TEO",
                    "middleName": null,
                    "lastName": "GI",
                    "nationality": "SG",
                    "dateOfBirth": null,
                    "kycMode": "MANUAL_KYC",
                    "address": {
                        "addressLine1": "15 ST. GEORGE'S ROAD",
                        "addressLine2": "05-166",
                        "city": null,
                        "state": null,
                        "country": "SG",
                        "postcode": "32015"
                    },
                    "contactDetails": null,
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": [
                     {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "SG",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }  
                    ]
                },
                "businessPartner": null
            }
        ],
		"applicantDetails": {
                    "firstName": "TEO",
                    "middleName": null,
                    "kycMode": "MANUAL_KYC",
                    "lastName": "jksdhf",
                    "nationality": "GB",
                    "dateOfBirth": "1989-10-10",
                    "address": {
                        "addressLine1": "15 ST. GEORGE'S ROAD",
                        "addressLine2": "05-166",
                        "city": "LONDON",
                        "state": "LONDON",
                        "country": "GB",
                        "postcode": "32015"
                    },
                    "contactDetails": {
                    	"contactNo": "32423411",
                    	"countryCode": "SG",
                    	"email": "[email protected]"
                    },
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR",
                            "sharePercentage": null
                        }
                    ],
                    "documentDetails": null
                },
        "additionalInfo": {
            "searchId": "c0be4204-698b-4c76-b17b-48d977304286",
            "isSameBusinessAddress": "yes"
        }
    },
    "riskAssessmentInfo": {
        "totalEmployees": "EM009",
        "annualTurnover": "SG011",
        "industrySector": "IS144",
        "intendedUseOfAccount": "IU003",
        "countryOfOperation": [
        	"SG",
        	"US",
        	"GB"
        ],
        "transactionCountry": [
        	"DE",
        	"JP",
        	"IN"
        ]
    }
}

Completing applicant eKYC

For Singapore residents, the applicant eKYC is done via MyInfo.

To simulate different success and error responses of the eKYC flow, use the following conditions on the applicant's phone number. In all cases, the applicant needs to open the redirectURL in their browser. You either land on the vendor’s page or receive a success/failure redirection back to your client KYC redirect URL without any actions needed on the UI. The redirectURL has isSuccess, errorCode, and errorMessage parameters as described in Applicant KYC.

Based on businessDetails.applicantDetails.contactDetail.contactNumber, there are two outcomes:

First two digits of contactNumberResulting situation
Doesn't contain any of the simulated patternsMyinfo’s sandbox page is opened and the applicant needs to complete the simulated authentication on the UI. This can be used for end-to-end testing.
Does contain any of the simulated patternsThe customer's browser redirects to your KYC redirect URL without the need of any actions on the UI. Redirection will contain the following Redirection parameters

Redirection parameters

Return codeQuery parameters in the redirection
21isSuccess = false; errorCode = R500; errorMessage = internalServerError
71isSuccess = false ; errorCode = I400; errorMessage = vendorValidationError
91isSuccess = true ; errorCode =; errorMessage =

Opening the redirect URL twice will generate the verification already completed scenario:

isSuccess = false ; errorCode =; errorMessage=verificationAlreadyCompleted

Completing applicant eDocVerify

For non-Singapore residents, the applicant eDocVerify is done via the third-party vendor Onfido. Applicant KYC via Onfido takes place for the Singapore region when the KYC mode is E_DOC_VERIFY.

To simulate different success and error responses of the eDocVerify flow, use the following conditions on the applicant's phone number. In all cases, the applicant needs to open the redirect URL in their browser. You either land on the vendor’s page or receive a success/failure redirection back to your KYC redirect URL without any actions needed on the UI. The redirectURL has isSuccess, errorCode, and errorMessage parameters as described in Applicant KYC.

Based on businessDetails.applicantDetails.contactDetail.contactNumber, there are two outcomes:

First two digits of contactNumberResulting situation
Doesn't contain any of the simulated patternsOnfido's sandbox page is opened and the applicant needs to complete the simulated authentication on the UI. This can be used for end-to-end testing.
Does contain any of the simulated patternsThe customer's browser redirects to your KYC redirect URL without the need of any actions on the UI. Redirection will contain the following Redirection parameters

Redirection parameters

Return codeQuery parameters in the redirection
91isSuccess=true; errorCode=;erroressage=
41isSuccess = false ; errorCode = R403; errorMessage = documentAlreadySubmitted
51isSuccess = false ; errorCode = I500; errorMessage = unexpectedError
61isSuccess = false ; errorCode = R408; errorMessage = redirectUrlExpired

Note: You can simulate verificationAlreadyCompleted message by clicking on the redirectURL after completing verification.

Simulate scenarios in the manual KYB flow

You might want to test transactions without going through the onboarding flow. To enable this, Nium provides simulated requests which get approved without manual intervention in the manual KYB flow.

You can generate approved application scenarios for manual KYB only in the sandbox environment. In production, every application is reviewed by Nium's compliance analysts before approval.

Simulated scenarioConditionsExamples
Approved applicationBRN contains M01 and stakeholderDetails.firstName starts with AA for all individual stakeholders with kycMode = MANUAL_KYCBRN: M01324536, 234M01456, 12M01B325; Stakeholder firstName: AAshutosh, AAnthony

Call the Onboard Corporate Customer API with the following example request.

Example request: approved application

{
    "region": "SG",
    "businessDetails": {
        "referenceId": "6913aac9-cbd9-4783-8fd6-07ea9655dfec",
        "businessName": "Singapore Electronics 27779",
        "businessRegistrationNumber": "903287424M01233",
		"website":"www.singaporeelectronics.com",
        "businessType": "PRIVATE_COMPANY",
        "legalDetails": {
            "registeredCountry": "SG",
            "registeredDate": "2000-01-02"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "High Street 101, 56th Avenue",
                "addressLine2": "Hyung County",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "documentDetails": [
            {
                "documentType": "BUSINESS_REGISTRATION_DOC",
                "document": [
                    {
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                        "fileName": "BRD.pdf",
                        "fileType": "application/pdf"
                    }
                ]
            }
        ],
        "stakeholders": [
            {
                "referenceId": "d25c5c6f-d4b0-47a5-986e-7b50641b65fc",
                "stakeholderDetails": {
                    "firstName": "AAman",
                    "middleName": "C",
                    "lastName": "Bhargav",
                    "dateOfBirth": "1982-07-17",
                    "nationality": "IN",
                    "kycMode": "MANUAL_KYC",
                    "professionalDetails": [
                        {
                            "position": "DIRECTOR"
                        },
                        {
                            "position": "UBO",
                            "sharePercentage": "60"
                        }
                    ],
                    "address": {
                        "addressLine1": "7 Ang Mo Kio Street",
                        "addressLine2": "64 No.01-01",
                        "city": "Singapore",
                        "country": "SG",
                        "postcode": "28046"
                    },
                    "documentDetails": [
                        {
                            "documentType": "PASSPORT",
                            "documentExpiryDate": "2029-09-10",
                            "documentIssuanceCountry": "IN",
                            "documentNumber": "098734524",
                            "document": [
                                {
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
                                    "fileName": "Passport.pdf",
                                    "fileType": "application/pdf"
                                }
                            ]
                        }
                    ]
                }
            },
            {
                "referenceId": "006ebeeb-3ede-4f49-8381-1e382334131c",
                "businessPartner": {
                    "legalDetails": {
                        "registeredCountry": "FR"
                    },
                    "businessEntityType": "SHAREHOLDER",
                    "businessName": "Farto AgriTECH LIMITED",
                    "businessRegistrationNumber": "822843822"
                }
            }
        ],
        "applicantDetails": {
            "referenceId": "0c61376b-70c3-4d45-9193-0a6ddece4e0e",
            "firstName": "Hardik",
            "middleName": "",
            "lastName": "Roshan",
            "dateOfBirth": "1982-07-17",
            "nationality": "SG",
            "kycMode": "E_KYC",
            "contactDetails": {
                "contactNo": "222268870",
                "countryCode": "SG",
                "email": "[email protected]"
            },
            "professionalDetails": [
                {
                    "position": "SIGNATORY"
                }
            ],
            "address": {
                "addressLine1": "7 Ang Mo Kio Street",
                "addressLine2": "64 No.01-01",
                "city": "Singapore",
                "country": "SG",
                "postcode": "28046"
            }
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes",
            "searchId": "6nf3aac9-cbd9-423k-8fd6-07ea9345dfec"
        }
    },
 "riskAssessmentInfo": {
    "totalEmployees": "EM009",
        "annualTurnover": "SG011",
        "industrySector": "IS144",
        "intendedUseOfAccount": "IU003",
        "countryOfOperation": [
            "SG",
            "US",
            "GB"
        ],
        "transactionCountry": [
            "DE",
            "JP",
            "IN"
        ]
  },
    "tags": [
        {
            "key": "tag1",
            "value": "tag1value"
        },
        {
            "key": "tag2",
            "value": "tag2value"
        }
    ]
}