Authentication

Create an access token for the Recipients embedded experience

Changed on

Generates an access token to run the Recipients frontend embedded experience using Mangopay Elements.

The OAuth bearer token you use to call this endpoint must be generated using an API key with specific permissions.

A single access token can be used to service the experience to one user and has a lifespan of 15 minutes. You need to provide the UserId of the Natural User or Legal User who will use the frontend session to register a Recipient.

post/v2.01/oauth/token/embedded/recipient

Request

  • Base URL
    https://api.sandbox.mangopay.com
  • URL
    https://api.sandbox.mangopay.com/v2.01/oauth/token/embedded/recipient
  • Auth
    HTTP bearer

Request body

clientIdstring required

Your Mangopay Client ID.

Response

Success

access_tokenstring

The value to use as the clientToken when initializing Mangopay Elements for the Recipients embedded experience.

token_typestring

Returned values: Bearer

The type of the token.

expires_ininteger

The number of seconds until the token expires.

scopestring

Returned values: bankaccounts:r bankaccounts:w

The API permission scopes of the token, in this case to read and write bank account data.

Changes

  • f44a59c76515Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e731ec4a85bRevision changes
    • info

      api operation id create_access_token_recipient removed and replaced with authentication_create_access_token_recipient