NeudAuth OAuth2 Integration for Paymenter

This guide will walk you through the process of installing the NeudAuth extension for Paymenter.

📦 Configuration

1. Create a NeudAuth OAuth Client

Navigate to your dashboard: https://ricardoneud.com/dashboard/oauth2

Click Generate OAuth Client.

Fill out the fields:

Name: Enter a recognizable name for your client.

Logo (Optional): Upload a logo if desired.

Terms of Service URL (Optional): e.g., https://example.com/terms

Privacy Policy URL (Optional): e.g., https://example.com/privacy

Scopes: Select Read Profile (only this scope is required).

Redirect URIs: Add at least one, e.g., https://yourpaymenterurl.tld/oauth2/ricardoneud-com/callback

Click Generate.

Copy the Client ID, Client Secret, and ensure the Redirect URI matches exactly the one configured in Paymenter.

⚠ Important: Store the Client Secret securely; it will be used in Paymenter configuration.

2. Configure the Extension in Paymenter

Navigate to Extension Settings in your Paymenter admin panel.

Enable the NeudAuth extension.

Input the following:

Client Name (for internal management)

Client ID

Client Secret (securely hidden)

Redirect URI

Save the configuration.

To allow users to log in via Ricardoneud.com:

Open your theme login template:

Locate the existing provider buttons block:

<div class="grid grid-cols-1 gap-4 sm:grid-cols-2 w-full">
    @foreach (['github', 'google', 'discord'] as $provider)
        @if (config('settings.oauth_' . $provider))
        <a href="{{ route('oauth.redirect', $provider) }}" class="flex items-center justify-center w-full py-2.5 border border-background bg-primary dark:bg-background rounded-lg text-white hover:bg-secondary hover:border-secondary transition-all space-x-2">
            <img src="/assets/images/{{ $provider }}-light.svg" alt="{{ ucfirst($provider) }}" class="size-5 block dark:hidden">
            <img src="/assets/images/{{ $provider }}-dark.svg" alt="{{ ucfirst($provider) }}" class="size-5 hidden dark:block">
            <span class="text-sm font-medium">{{ ucfirst($provider) }}</span>
        </a>
        @endif
    @endforeach
</div>

Add the NeudAuth button directly below this block:

@if(!config('settings.oauth_neudauth', false))
<a href="/oauth2/ricardoneud-com/authorize" class="flex items-center justify-center w-full py-3 mt-4 border border-background bg-primary dark:bg-background rounded-lg text-white hover:bg-primary hover:border-secondary transition-all space-x-2">
    <img src="https://cdn.ricardoneud.com/logo.png" alt="Ricardoneud.com" class="size-5">
    <span class="text-sm font-medium">Sign in with Ricardoneud.com</span>
</a>
@endif

Ensure the registration link remains below the new button:

@if(!config('settings.registration_disabled', false))
<div class="mt-10 text-sm text-center text-neutral-400">
    {{ __("auth.dont_have_account") }}
    <a class="font-semibold text-primary transition-colors hover:text-secondary" href="{{ route('register') }}" wire:navigate>
        {{ __('auth.sign_up') }}
    </a>
</div>
@endif

Once configured, users can login with their account on Paymenter:

Go to the login.

Click Sign in with Ricardoneud.com.

Complete the OAuth flow, granting the requested permissions.

Upon success, the user’s account will be loggedin, and any configured access rights will be automatically applied.

✅ Completion

After these steps:

Users can log in via NeudAuth directly from your Paymenter login page.

Only the Read Profile scope is required for the login function to work.

Access rights can be applied automatically after verification.

This setup ensures secure account logging in while maintaining a seamless user experience across your platform.

Setting Up

NeudAuth OAuth2 Integration for Paymenter#

📦 Configuration#

1. Create a NeudAuth OAuth Client#

2. Configure the Extension in Paymenter#

3. Add NeudAuth Login Button#

4. User Login Flow#

✅ Completion#

NeudAuth OAuth2 Integration for Paymenter

📦 Configuration

1. Create a NeudAuth OAuth Client

2. Configure the Extension in Paymenter

3. Add NeudAuth Login Button

4. User Login Flow

✅ Completion