OAuth providers
Mercury
Set up Mercury OAuth for business banking and financial data
Overview
Section titled “Overview”Connect your users to Mercury for business banking data, account balances, transactions, and financial management.
| Property | Value |
|---|---|
| Provider ID | mercury |
| Category | Finance & HR |
| PKCE | Supported |
| Token refresh | Automatic |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Mercury OAuth App
Section titled “Step 1: Create a Mercury OAuth App”Review Mercury's OAuth integration guide
Open Mercury’s OAuth2 integration guide and submit an integration request. Mercury does not offer a self-serve developer console for OAuth.
Wait for Mercury to provision credentials
After approval, Mercury provides a Client ID and Client Secret.
Register the redirect URI
Provide the Alter callback URL from the Developer Portal as the registered Redirect URI.
Enter credentials in Alter Vault
Use the Client ID and Client Secret from Mercury in the Developer Portal (see Step 2 below).
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Mercury provider
Go to OAuth Providers > Add Provider > Mercury.
Enter credentials
- Client ID: Paste your Mercury Client ID
- Client Secret: Paste your Mercury Client Secret
Select scopes
Choose the scopes the application needs.
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”| Scope | Description |
|---|---|
read | Read-only access to account and transaction data |
offline_access | Maintain continuous access with refresh tokens |
- Request only the scopes the application needs. For read-only financial dashboards,
readis sufficient. - See the Mercury OAuth documentation for more details.