v1

latestOpenAPI 3.1.02026-07-2021032.0 KB
Hosted Onboarding Page

Get a link to a Adyen-hosted onboarding page

Returns a link to an Adyen-hosted onboarding page (HOP) that you can send to your account holder. For more information on how to use HOP, refer to Hosted onboarding.

post/getOnboardingUrl

Request body

accountHolderCodestring required

The account holder code you provided when you created the account holder.

editModeboolean

Indicates if editing checks is allowed even if all the checks have passed.

mobileOAuthCallbackUrlstring

The URL to which the account holder is redirected after completing an OAuth authentication with a bank through Trustly/PayMyBank.

platformNamestring

The platform name which will show up in the welcome page.

returnUrlstring

The URL where the account holder will be redirected back to after they complete the onboarding, or if their session times out. Maximum length of 500 characters. If you don't provide this, the account holder will be redirected back to the default return URL configured in your platform account.

shopperLocalestring

The language to be used in the page, specified by a combination of a language and country code. For example, pt-BR.

If not specified in the request or if the language is not supported, the page uses the browser language. If the browser language is not supported, the page uses en-US by default.

For a list of supported languages, refer to Change the page language.

Response

OK - the request has succeeded.

pspReferencestring

The reference of a request. Can be used to uniquely identify the request.

redirectUrlstring

The URL to the Hosted Onboarding Page where you should redirect your sub-merchant. This URL must be used within 30 seconds and can only be used once.

resultCodestring

The result code.

submittedAsyncboolean

Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied:

  • true: The request is queued and will be executed when the providing service is available in the order in which the requests are received.
  • false: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.
All 2 operations