Skip to main content

How To: Update my Integration Credentials

Updated

Overview

The purpose of this article is to outline the steps required to update third-party integration credentials in ScanX. From time to time (for example: Experian), these credentials may expire, and you will need to update them to ensure the scorecard integration continues to function properly in ScanX.

Prerequisites

  • In ScanX: You must be a Company Administrator with ScanX Editor permissions.
  • Third-Party integration provider: You must have the appropriate security permissions to update or change passwords.

Update Integration Credentials

These steps need to be completed for all Scorecards that use the account. It's important to update and replace expired third-party credentials in ScanX as soon as possible to avoid scorecard disruptions.

Step 1: Accessing Credential Manager in ScanX

  1. Click on "Administration" on the top menu bar
  2. Select Scorecards



  3. Identify the live Scorecard(s) you wish to update and click on the Scorecard hyperlink


Step 2: Updating credentials

  1. The Scorecard editor will open in a new tab. Select Credential Manager
  2. The next screen will display all of the Third Party Integrations this specific scorecard is connected with. Click on the key icon for each Integration to make the required updates.


  3. Add the new credentials and click Save. Then save the Scorecard.

After completing those steps, you should be able to return to the Scorecard and rerun any scoring rules that failed due to expired credentials.

 

Understanding Integration Credential Fields

When you’re entering credentials for a third-party integration, the field names in ScanX may not always match exactly what your third party provider uses. Below is a guide to help you map the labels you see in ScanX with the equivalent terms your provider may use as well as some examples of the inputs. This will help reduce confusion and ensure you enter the correct information in each field

Experian NetConnect (BIS)

  • EXPERIAN_INT_BIS_USERID — User ID
    Example: lowercasecompany
  • EXPERIAN_INT_BIS_PASSWORD — Password
    Example: Password123 (cannot have special characters)
  • EXPERIAN_INT_BIS_SUBCODE — Subcode
    Example: 1234567
  • testModeEnabled — This enables Test Mode
    Example: false

 

 

Experian Consumer JSON (Personal Credit)

  • EXPERIAN_SERVICE_BASE_URL — Service URL
    Example: https://uat-us-api.experian.com/
  • EXPERIAN_CONSUMER_USERID — Username
    Example: NMIAPI
  • EXPERIAN_CONSUMER_PASSWORD — Password
    Example: Password123 (cannot have special characters)
  • EXPERIAN_CONSUMER_CLIENTID — Consumer Key
    Example: SamPl3nmIsAmpL3SamPl3nmIsAmpL3Sa
  • EXPERIAN_CONSUMER_CLIENT_SECRET — Consumer Secret
    Example: SamPl3nmIsAmpL3S
  • EXPERIAN_SUBSCRIBER_CODE — Subscriber Code
    Example: 1234567
  • EXPERIAN_RISK_MODEL — Risk Model
    Examples:
      • F9 → FICO 9
      • AF → FICO 8
      • F → FICO 2
      • V4 → Vantage 4
      • V3 → Vantage 3

  • ACCOUNT_PURPOSE_TYPE_CODE — Permissible Purpose / Account Type
    Example: 5K
  • testModeEnabled — This enables Test Mode
    Example: false

 

Mastercard MATCH

  • MC_ENVIRONMENT — Environment
    Example: production
  • MC_KEY_ALIAS — Key Alias
    Example: Companynmi
  • MC_KEY_PASSWORD — Key Password
    Example: P@ssword123
  • MC_CONSUMER_KEY — Consumer Key
    Example: SamPl3nmIsAmpL3SamPl3nmIsAmpL3!SamPl3nmIsAmpL3SamPl3nmIsAmpL30000000000
  • MC_ACQUIRER_ID — ICA(s) (Acquirer ID)
    Example: 12345
  • MC_KEY_FILE — Key File
    Example: MatchNmiTest.p12 (this should match the file name you uploaded)

 

 

TransUnion (US)

You will likely be provided the Enablement Subscriber Code from TransUnion. This code is broken up into parts of the credentials needed for the integration:
Format: <SUBSCRIBER_PREFIX (1234)> <TRANSUNION_MEMBER_CODE (X1234567)> <SUBSCRIBER_INDUSTRY (X)
Example: 1234X1234567

  • TransUnion Member Code — Member Code
    Example: X1234567
  • Subscriber Prefix — Subscriber Prefix
    Example: 1234
  • Subscriber Industry Code — Industry Code
    Example: X
  • Subscriber Password — Subscriber Password
    Example: AB12
  • TransUnion Key Password — Key Password
    Example: SamPl3nmIsAmpL3
  • TransUnion Key Alias — Key Alias
    Example: SamPl3-nmI3-nmI3-nmI3-sAmpL312345 (this is auto-generated)
  • TransUnion Score Key — Score Key / Risk Model
    Examples:
      • 001NN → Vantage 4
      • 00V60 → Vantage 3
      • 00P02 → FICO V4
      • 00Q88 → FICO V8
      • 00W18 → FICO V9