PayoutID OAuth

Supported grants are:

• authorization code grant
• refresh token grant
• client credential grants

Authorization code grant

In this code grant, when integrator need to receive some data or do any action on behalf of user. He needs first to redirect him to authorization url. There are separate url's for each environment:

• https://sandbox.payout.one/oauth - for sandbox environment
• https://app.payout.one/oauth - for production environment

Authorization flow is going as follow:

1. User need to be redirected to authorization endpoint:
   • for sandbox PayoutID API: Authorization redirect for user
   • for production PayoutID API: Authorization redirect for user
2. User needs to authenticate self (login or register) and then is asked to approve access to requested scopes to integrator. Possible scopes are descriped in concrete endpoints required them.
3. User is redirected back to integrator with authorization_code in query parameters.
4. Integrator uses authorization_code to retrieve access_token using token endpoint:
   • for sandbox PayoutID API: Endpoint to retrieve authorization token
   • for production PayoutID API: Endpoint to retrieve authorization token
5. Integrator now can work with chosen endpoint passing access_token in Authorization header.

This flow also can be seen at next diagram:

Refresh token grant

Authorization code is time constrained. For security reason, expiration times are short and should not be longer that one hour. To allow for longer access to resource, refresh token is issued with every authorization code access token which can have expiration time up to 90 days. Hovever, it is not alloweed to access endpoints with this token and only can be used to issue new access_token.

This token is issued by passing refresh_token as grant and retrieved refresh token as refresh_token to token API:

• for sandbox PayoutID API: Endpoint to retrieve authorization token
• for production PayoutID API: Endpoint to retrieve authorization token

Client credentials grant

In some cases, integrator can use this grant to access resources without consent from user in IS Payout. In cases where user need to authenticate resources from different service provider, for instance Bank, authentication on service provider might still be required. In case of this grant, integrator can directly request token with his client_id and client_secret. No authorization code is required.