Authorize¶
GET
https://my.mollie.com/oauth2/authorize
Note
You should construct the Authorize URL from the endpoint above with the parameters below. Then, you should redirect the resource owner to the Authorize endpoint.
The Authorize endpoint is the endpoint on Mollie web site where the merchant logs in, and grants authorization to your client application. E.g. when the merchant clicks on the Connect with Mollie button, you should redirect the merchant to the Authorize endpoint.
The resource owner can then grant the authorization to your client application for the scopes you have requested.
Mollie will then redirect the resource owner to the redirect_uri
you have specified. The redirect_uri
will be
appended with a code
parameter, which will contain the auth token. You should then exchange the auth token for
an access token using the Tokens API.
Parameters¶
client_id
stringrequiredThe client ID you receive when registering your app. This starts with app_
.
Example: app_j9Pakf56Ajta6Y65AkdTtAv
.
redirect_uri
stringoptionalstate
stringrequiredstate
query
parameter when the user returns to the redirect_uri
after authorizing your app.scope
stringrequiredA space-separated list of permissions your app requires. Refer to Permissions for more information about the available scopes.
Example organizations.read profiles.read payments.read payments.write
response_type
stringrequiredMollie only replies with code responses.
Possible values: code
approval_prompt
stringoptionalThis parameter can be set to force
to force showing the consent screen to the
merchant, even when it is not necessary. Note that already active authorizations will be revoked when the user
creates the new authorization.
Possible values: auto
force
locale
stringoptionalAllows you to preset the language to be used in the login and sign up flow if the merchant is not logged in. If the merchant is already logged in, his/her preferred language will be used and this parameter is ignored.
When this parameter is omitted, the browser language will be used instead. You can provide any xx_XX
format ISO 15897 locale, but the authorize flow currently only supports the following languages:
Possible values: en_US
nl_NL
nl_BE
fr_FR
fr_BE
de_DE
es_ES
it_IT
landing_page
stringoptionalAllows you to specify if Mollie should show the login or the signup page, when the merchant is not logged in at
Mollie. Defaults to the login page. Defaults to login
.
Possible values: login
signup
Response¶
301 Redirect
Errors are indicated by redirecting back to the provided redirect URL with additional parameters in the query string (as per the OAuth2 specification).
There will always be an error
parameter, and the redirect may also include error_description
.
code
stringstate
stringerror
stringerror
field. The field will contain a code indicating the type of error.error_description
stringerror
field is present, this field will be present as well with an explanation of the error code.In case of an invalid value, your user will be redirected to the redirect URI set for your OAuth application with
the error
and error_description
query parameters added.
Example¶
Refer to the documentation of the Mollie API client you are using.