HomeMerchantsProject InformationContact
  • English
  • Română

    • Your all in one
    unique ID solution

    Take the first step into a
    future with Biometrics.

    Download on the App Store Download form Google Play

    MyIdentity Smart Buttons Overview

    MyIdentity Smart Buttons gives your business a simplified and secure way to accessing user’s personal information.

    Try the buttons

    Click the button below to experience a complete identification with MyIdentity:

    Merchant secret
    Customer data
    
                    {
                      "firstName": "John",
                      "lastName": "Smith",
                      "isAlive": true,
                      "age": 27,
                      "address": {
                        "streetAddress": "21 2nd Street",
                        "city": "New York",
                        "state": "NY",
                        "postalCode": "10021-3100"
                      },
                      "phoneNumbers": [
                        {
                          "type": "home",
                          "number": "212 555-1234"
                        },
                        {
                          "type": "office",
                          "number": "646 555-4567"
                        }
                      ],
                      "children": [],
                      "spouse": null
                    }

    FOR DEVELOPERS

    Add the buttons to your site

    Now that you have seen the button in action, add the button code to your site. Copy and paste this code into an HTML page and view it in your browser. You’ll use the code to start a basic integration.

    
            <script src="https://www.myidentity.bio/sdk/js?client-id=test"></script>
            <script>myidentity.Buttons().render('body');</script>

    Tip: To log in to MyIdentity after you click the smart button, create a sandbox account.

    How the buttons work

    Before you begin the integration, here’s a big-picture view of how the MyIdentity Smart Button integration works:

    1. You add the MyIdentity Smart Button to your site’s page
    2. Your buyer/user clicks the button
    3. The button calls the MyIdentity identification API to request an identification session
    4. The button launches the MyIdentity identification process
    5. The buyer/user completes the identification process by either using the iOS or Android mobile apps
    6. When the identification of the buyer/user is completed successfully you use the confirmation response, your private client secret and your public client id to request the user’s data from MyIdentity’s API
    7. The process is now completed and you can show a confirmation to your buyer/user or take him to his account

    Add the Button to your site

    This integration guide helps you to:

    • Render the MyIdentity Smart Button on your site
    • Set up the identification process to validate users before they can take actions on your site
    • Test the button and take it live

    1. Set up your Sandbox Environment

    To generate REST API credentials for the sandbox and live environments:

    1. Log into the Merchant Dashboard with your MyIdentity Merchant account (or register for one here)
    2. In the dashboard make sure you’re on the “Sandbox” tab to get the API credentials you’ll use while you’re developing the integration code. After you test and before you go live, switch to the “Live” tab to get your production credentials.
    3. Create a new secret. Store the secret value securely and do not share it or publish it anywhere. Also, once you close the popup with the secret you won’t be able to get the value going further. You are allowed to create new secrets and rotate them in case you loose your secret value.

    2. Add the MyIdentity JS SDK to your site

    
            <!DOCTYPE html>
            <head>
              <meta name="viewport" content="width=device-width, initial-scale=1"> 
              <meta http-equiv="X-UA-Compatible" content="IE=edge" /> 
            </head>

            <body>

            
              <script
                src="https://www.myidentity.bio/sdk/js?client-id=YOUR_CLIENT_ID"> // Required. Replace YOUR_CLIENT_ID with your sandbox client ID.
              </script>
            </body>

    3. Render the Smart Button

    
            <body>
            
              <script
                src="https://www.myidentity.bio/sdk/js?client-id=YOUR_CLIENT_ID"> // Required. Replace YOUR_CLIENT_ID with your sandbox client ID.
              </script>

              <div id="myidentity-button-container"></div>

              <script>
                myidentity.Buttons().render('#myidentity-button-container');
                // This function displays the Identify Smart Buttons on your page.
              </script>
            </body>

    4. Set up the identification process

    Implement the onApprove function, which is called when your buyer/user is successfully identified.

    
            myidentity.Buttons({
              onApprove: function(data) {
              // The data object represents a successfull identification sessions.
              // It does not contain any specific user details
              // The data object is sent to your own login api which uses the
              fetch('/your-own-login-url', {
                // other `fetch` function call configuration attributes, like method, headers, etc
                body: JSON.stringify(data)
              })
                .then((response) => {
                  // Process your own successul login response
                })
                .catch((err) => {
                  // Process your failed successul login response
                })
              }
            }).render('#myidentity-button-container');

    5. Test the integration

    6. Go live

    1. Go to your MyIdentity dashboard
    2. Make sure you are on the “Live” tab
    3. Generate a new secret
    4. Make sure to use the new client id on your production site. Make sure on your API’s production version to use the “Live” client secret assigned to the client id
    5. Select the user fields you are interested in getting access to
    6. Publish your production version