KVK Number Suggestion

SurePay offers an add-on service called KVK number suggestion. By enabling this feature, customers can obtain the 'knownAtBankId' field in the API response body, which allows them to quickly determine what's the current KVK number of a company, if the inputted one is not correct. This dedicated field ensures that the information is clearly presented to the user. The 'knownAtBankId' field information can be used to discover fraud on invoices.

To gain access to SurePay's add-ons, customers are required to notify service@surepay.nl first. This notification is essential to enable access to these additional features.

Request

To receive the 'knownAtBankId' field for a provided account, there are no changes required in the regular API request body. The complete description of the API request can be found in the API Specification. The headers are also explained in the same section.

Response

In the response, the 'knownAtBankId' field will be included as an additional field in the 'companyIds' object, without any changes in the rest of the response. This field will be returned in case of a 'matchResult' is equal to NO_MATCH (for a KVK number provided in the request). The following table shows the field specifications:

  • Name
    knowAtBankId
    Type
    String
    Tag(s)
    Conditionally Returned
    Description

    A suggestion of the unique identifier associated with an entity that has been formally acknowledged and verified at its source (the bank).

Request

POST
/account/check/organisations

{
    "accountId": {
        "value": "NL34SRPY0000000006",
        "type": "IBAN"
    },
    "companyIds": [
        {
        "companyIdType": "NL_KVK",
        "companyIdValue": "54890382"
        },
        {
        "companyIdType": "NL_KVK_BRANCH",
        "companyIdValue": "000012839132"
        }
    ]
}

Response

{
    "nameMatchResult": "COULD_NOT_MATCH",
    "dataUsedForMatching": "VERIFIED",
    "companyIds": [
        {
            "type": "NL_KVK",
            "matchResult": "NO_MATCH",
            "knownAtBankId": "54892382"
        },
        {
            "type": "NL_KVK_BRANCH",
            "matchResult": "MATCH"
        }
    ],
    "account": {
        "accountNumberValidation": "VALID",
        "paymentPreValidation": "PASS",
        "optedOut": false,
        "status": "ACTIVE",
        "accountType": "ORG"
    },
    "scheme": "SurePay"
}
Previous
Next