Setting up Single Sign-On (SSO) with Google or Microsoft

Setting up Single Sign-On (SSO) with Google or Microsoft

Single Sign-On (SSO) lets your users sign in to Paytia with their existing Google or Microsoft account. You can set up SSO from the SSO Services panel on your Paytia Settings page.

On screen you'll see:

To setup Paytia Single Sign on (SSO), please choose your preferred operating environment below.

Before you start

  • You'll need to be able to log in to the Paytia merchant portal and open Settings.
  • If you're setting up Microsoft, you'll need help from your Microsoft Administrator.

Step 1: Open the SSO Services panel

  1. Log in to the Paytia merchant portal.
  2. Click the Settings menu. (The page address ends in /portal/merchant/setting.)
  3. Find the SSO Services panel.

SSO Services panel with no provider selected

Step 2: Choose your SSO provider

  1. Under Select SSO Provider, choose Google or Microsoft.
  2. Follow the section below for the provider you chose.

Option A: Set up SSO with Google

Google is the simplest option. You don't need to enter any other details.

  1. Under Select SSO Provider, select Google.
  2. Click Save.

SSO Services panel with Google selected

That's it. Your users can now log in and authenticate with Google when they sign in.

Option B: Set up SSO with Microsoft

If you select Microsoft, you'll see two tabs: Consent and Manual. Use one of them.

  • Consent: a Microsoft Administrator approves the Paytia application for your whole organisation.
  • Manual: you enter the details of your own application registration from Microsoft Entra ID.

Microsoft: Consent tab

A Microsoft Administrator must grant consent to the Paytia application. Once they approve it, all of your organisation's users can log in to Paytia without seeing the approval screen.

  1. Under Select SSO Provider, select Microsoft.
  2. Open the Consent tab.
  3. Click Grant Microsoft Admin Consent. A Microsoft Administrator must complete this step.
  4. Once consent has been granted, click Save.

Microsoft selected, Consent tab

Microsoft: Manual tab

Use the Manual tab if you want to connect Paytia to an application you've registered in your own Microsoft Entra ID.

First, add the Paytia Redirect URI in Microsoft Entra ID

  1. In Microsoft Entra ID, go to App registrations, then select your application.
  2. Open Authentication, then go to Redirect URIs.
  3. Add this Redirect URI, with the type set to Web:
    https://accounts.paytia.com/portal/sso_callback

Then, enter your details in Paytia

  1. Under Select SSO Provider, select Microsoft.
  2. Open the Manual tab.
  3. In Client ID, enter your application's Client ID.
  4. Under Authentication Type, choose Client Secret or Certificate.
    • Client Secret: enter your client secret in the Client Secret field.

    Manual tab with Client Secret selected

    • Certificate: upload your certificate file (.pfx or .p12), then enter its password in Certificate Password.

    Manual tab with Certificate selected

  5. In Tenant ID, enter your Microsoft tenant ID. You'll need this whichever Authentication Type you choose.
  6. Click Organisation detail.

Keep your credentials safe: never share your client secret, certificate file or certificate password by email or in a support ticket. Paytia Support will never ask you for them.

Having trouble signing in with Microsoft?

See Paytia SSO – Troubleshooting Microsoft Entra Sign-In Issues.

Related articles