User Authorization

User Authorization

Authorization endpoint

To begin the authentication process, your user will access Checkbook's OAuth authorization endpoint:


Sandbox OAuth

If you would like to test the OAuth flow in Sandbox, use this authorization endpoint:

This URL requires 4 query parameters which are:

Query parameterDescription
client_idYour client ID found in Developer Keys
scopeOne of the following values:
  • check: the token can be used multiple times to send or request checks
  • check_receive: the token can be used multiple times to request checks
  • single-use: the token can be used only once to send or request checks
    | redirect_uri | Your callback URL found in Developer Keys |

Here is an example of an authorization endpoint containing all query parameters:



The previous URL is for the demo environment and cannot be used for an actual OAuth implementation. You will need to use either the sandbox or the production authorization endpoint.

Get user's authorization

The following page is displayed asking the user to login to its account.

Alt text

If the user does not have a account, then a signup form will be displayed.

Alt text

After the signup, Checkbook requires the new user to verify its email address by entering the 6-digit code sent to the email provided.

Alt text

Finally, the user will also be prompted to Complete its profile and Add a bank account before being able to Authorize a Payment.

Alt text

After the user successfully authenticates, the following dialog will be displayed allowing to either Deny or Authorize your business to use on its behalf.

Alt text

Once the user confirms they wish to allow a third party to send checks on their behalf, their browser will be redirected to the callback URI that has been specified in the Developer Keys, along with an AUTHORIZATION_CODE:


What’s Next