Use the following settings when configuring PayNearMe on your Azure instance, which will use these settings to generate the SAML certificate for your site.

📘

Sandbox vs. Production

The settings below are for the sandbox environment. You will need to generate a new certificate for the production environment.

Basic SAML Configuration

Attributes and Claims

Setting Up Enterprise Applications

Define two Entra ID enterprise applications, one each for sandbox and production environments. The following are instructions for setting up the sandbox enterprise application. Repeat these instructions for production.

1. Click New application. In the Entra ID Enterprise applications > All applications blade.

   

2. Click on Create your own application in the new page.

   

3. Enter PayNearMe Sandbox as the name of the new app, and select Integrate any other application you don’t find in the gallery (Non-gallery).

   

4. Open the Manage > Single sign-on blade for the newly created application.

   

5. Click edit in the Basic SAML Configuration box.

   

6. Add the provided instance id value in the Identifier (Entity ID).

7. Add https://pro.paynearme-sandbox.com/users/saml/auth as the Reply URL (Assertion Consumer Service URL).

8. Click Save.

   

Configuring the SAML Claims Using Entra ID Security Groups

The user_type claim controls the application role assumed by the user in PayNearMe. The following instructions assume two application roles, agent and merchant, and one PayNearMe site, PayNearMe Sandbox.

1. Define one Entra ID security group for each application role. Choose a prefix that identifies the site, and append the application role to it. For example, PayNearMe-Sandbox-, with the security groups being PayNearMe-Sandbox-agent and PayNearMe-Sandbox-merchant.

   1. Open the Entra ID Groups > All groups blade in the Azure Portal:

      

   2. Click New group.

   3. Fill in the details below:

      

   4. Click Create.

   5. Repeat for all application roles.

2. Assign the security groups to the corresponding enterprise application.

   1. Locate the enterprise application in the Enterprise applications blade:

      

   2. Click on the enterprise application name.

   3. Select the Manage > User and groups section.

   4. Click Add user/group and add all security groups created in step 1.

   5. The final result should be:

      

3. Define the SAML claims.

   1. Locate the enterprise application in the Enterprise applications blade:

      

   2. Click on the enterprise application name.

   3. Select Single sign-on:

      

   4. Click Edit under Attributes & Claims section.

      

   5. Delete all additional claims by clicking the ... menu next to each default claim, selecting Delete and confirming.

   6. Add the following claims:

      Name	Source	Value
      urn:mace:dir:attribute-def:email	Attribute	user.mail
      first_name	Attribute	user.givenname
      last_name	Attribute	user.surname
      site	Attribute	"<provided site value>"

      

   7. Click Add a group claim and enter the following (values listed in the text below
      screenshot):

      Field	Value
      Which groups associated with the user should be returned in the claim	Groups assigned to the application
      Source attribute	Cloud-only group display names
      Filter groups	Checked
      Attribute to match	Display name
      Match with	Prefix
      String	PayNearMe-Sandbox
      Customize the name of the group claim	Checked
      Name	user_type
      Namespace	Leave empty
      Emit groups as role claim	Unchecked
      Apply regex replace to groups claim content	Checked
      Regex pattern	^PayNearMe-Sandbox-(?'role'.*)$
      Regex replacement pattern	{role}
      Expose claim in JWT tokens in addition to SAML tokens	Unchecked

      

   8. Click Save.

   9. The Attributes & Claims should be:

      

   10. Add users to the security groups as appropriate. Users will now be redirected and logged in to the PayNearMe site when accessing the enterprise application.

❗️

Users and Security Groups

A user should only be added to a single security group for each site. For example, if you have configured two sites, PayNearMe Sandbox and PayNearMe Production, a user can belong to PayNearMe-Sandbox-agent and PayNearMe-Production-merchant, but not to PayNearMe-Sandbox-agent and PayNearMe-Sandbox-merchant. In the latter scenario the resulting user_type claim for PayNearMe Sandbox will be malformed and the user won't be able to access the
PayNearMe site.

Generating Connection Values

After generating and sending PayNearMe the SAML certificate for your site, we’ll use the certificate to generate the certificate fingerprints and login URL for your configuration.

*This algorithm has been deprecated and may not work.