BVbvnk
Onboarding

Submit questionnaire

:::info Customers API v2 The new customer onboarding flow is recommended for all new integrations.

If you already have an existing integration with Customers API v1, you can continue using it. BVNK will continue to support this API going forward. :::

Submit questionnaire answers provided by your customers. BVNK validates completeness asynchronously and transitions the customer to the next onboarding state when all required answers are present. In case some answers are missing, BVNK specifies them and waits for all the answers to be submitted

put/platform/v1/customers/{customerReference}/questionnaires

Request

Path parameters

customerReferencestring uuid required
Example:52ec68a9-1ff1-4b7c-a8b5-0630de484e42

Unique customer reference (UUID or other immutable identifier) returned when the customer was created.

Request body

code'financialServicesQuestionnaireFull' | 'amlCryptoComplianceQuestionnaireFull' | 'gamblingQuestionnaireFull' | 'fintechsQuestionnaireFull' | 'otherQuestionnaireFull' | 'eddQuestionnaire' required

Questionnaire identifier

Example request

[
  {
    "code": "amlCryptoComplianceQuestionnaireFull",
    "sections": [
      {
        "code": "nature_of_business_section",
        "items": [
          {
            "code": "products_services_offered",
            "value": "embedded"
          }
        ]
      }
    ]
  }
]

Response

Submission accepted.

statusstring required
messagestring required

Example response

{
  "status": "success",
  "message": "Questionnaire submitted successfully."
}

Changes

No recorded changes to this operation across all 3 revisions of this API.