Wallet-as-a-ServiceAuthenticationDiscord

Discord Authentication

This guide walks you through setting up Discord OAuth as a custom authentication provider for your UTXOS application.

Custom authentication providers are available on Pro and Scale plans. The Base plan uses UTXOS-managed Discord credentials.

Prerequisites

Create Discord OAuth Application

  1. Navigate to the Discord Developer Portal.

  2. Click New Application and enter a name for your application.

  3. In the left sidebar, select OAuth2.

  4. Copy the Client ID and Client Secret from the Client information section.

⚠️

The Client Secret is only shown once. Store it securely before continuing.

  1. In the Redirects section, add the following redirect URL:
https://utxos.dev/api/auth
  1. Click Save Changes.

Discord OAuth2 configuration

Configure UTXOS Dashboard

  1. Open the UTXOS Dashboard and select your project.

  2. Navigate to Settings > Authentication.

  3. Select Discord from the provider list.

  4. Enter your credentials:

FieldValue
Client IDYour Discord OAuth Client ID
Client SecretYour Discord OAuth Client Secret

  1. Toggle Enable to activate Discord authentication.

  2. Click Save project settings.

Discord authentication settings in UTXOS dashboard

Verify the Integration

  1. Open your application and initiate the wallet connection flow.

  2. Select Login with Discord.

  3. Complete the Discord authorization process.

  4. Confirm you are redirected back to your application with an active wallet session.

Troubleshooting

”Invalid OAuth2 redirect_uri” Error

The redirect URI does not match your Discord application configuration. Verify that https://utxos.dev/api/auth is added exactly as shown in the Redirects section.

”Unknown Application” Error

Your Discord application may not be properly configured. Ensure the application is not deleted and the Client ID is correct.

”Invalid Client Secret” Error

Regenerate the Client Secret in the Discord Developer Portal and update it in the UTXOS dashboard.

Users Cannot Authorize

Check that your Discord application has the required scopes enabled. UTXOS requires the identify and email scopes for authentication.

Next Steps

OverviewGoogle