Skip to main content
This guide walks you through a full OAuth 2.0 integration with Monei Connect. By the end, your app will be able to redirect users to Monei, receive an authorization code, exchange it for tokens, and call the Monei API on the user’s behalf. Prerequisites: You’ve already registered your app and have a client_id and client_secret.

What we’re building

A simple web server that:
  1. Redirects a user to Monei to authorize wallet access
  2. Handles the callback and exchanges the code for tokens
  3. Calls GET /api/v1/wallet/me using the access token

Environment setup


The integration


Test it locally

You’ll be redirected to Monei’s consent screen. After approving, you land back at /dashboard with live wallet data.

What to do next

OAuth Flow Deep Dive

Understand every step in detail in state validation, error handling, edge cases

Handling Partial Grants

Users may approve fewer scopes than you requested, here’s how to handle that

Token Management

Refresh tokens before expiry, revoke on disconnect

All Scopes

Full reference of every scope and which endpoints it unlocks