Onboarding API

Submit onboarding data

Changed on

⚠️ We no longer recommend implementing this endpoint. Please refer to the Client Links API instead to kick off the onboarding process for your merchants.

Submit data that will be prefilled in the merchant's onboarding. The data you submit will only be processed when the onboarding status is needs-data.
Information that the merchant has entered in their dashboard will not be overwritten.

post/v2/onboarding/me

Request

  • Base URL
    https://api.mollie.com
  • URL
    https://api.mollie.com/v2/onboarding/me
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://my.mollie.com/oauth2/authorize
      Token URL: https://api.mollie.com/oauth2/tokens scopes: onboarding.write

Headers

idempotency-keystring
Example:123e4567-e89b-12d3-a456-426

A unique key to ensure idempotent requests. This key should be a UUID v4 string.

Request body

Example request

{
  "organization": {
    "name": "Mollie B.V.",
    "address": {
      "streetAndNumber": "Keizersgracht 126",
      "postalCode": "1015 CW",
      "city": "Amsterdam",
      "country": "NL"
    },
    "registrationNumber": "30204462",
    "vatNumber": "NL815839091B01",
    "vatRegulation": "dutch"
  },
  "profile": {
    "name": "Mollie",
    "url": "https://www.mollie.com",
    "email": "info@mollie.com",
    "phone": "+31208202070",
    "description": "Payment service provider",
    "businessCategory": "MONEY_SERVICES"
  }
}

Response

An empty response.

Changes

    • info

      added the non-success response with the status

    • info

      the endpoint scheme security advancedAccessToken was added to the API

    • info

      the endpoint scheme security organizationAccessToken was removed from the API