Integration Summary

Our integration with Pershing allows draft accounts in Pershing systems to be opened directly from within Practifi.  Integration initiates the opening of the draft account, which must be reviewed and concluded in the Pershing’s NetX360 Advisor Portal, after formalities with the end-client (review and signing of documents, completion of necessary details required for the account) are concluded.  The integration informs the Practifi Advisor the status of the account opening (as either in Draft, or Opened status).

In this implementation:

• Contact information is passed into Pershing to open a Draft Account
• Practifi monitors the status of the Draft Account process and shows its status (In Draft, or Opened) and the Account Type.

Before You Begin

The Practifi customer (advisor firm) must engage with their Pershing Account Executive, informing them that they wish to integrate their Practifi system with Pershing.  In particular, the customer needs to request to authorize the Open and update accounts APIs to be accessed by Practifi on their behalf. The following certificate signing process needs to be completed by Practifi on behalf of each customer:

• From within Salesforce generate a Certificate Signing Request (CSR) use (Generate CA-Signed Certificate option) then email to Pershing.

• Pershing will review the CSR and if approved, Pershing will email back a signed certificate to be installed on the customer’s Practifi system. Separately, a PLINK ID will be issued and emailed by Pershing to Practifi for this customer's advisor firm. Please note that a PLINK ID is issued per firm for the shared API entitlements across that firm.

To complete the configuration, the customer must supply (as issued by Pershing) to Practifi the following details for their firm:

• correspondentNumber - Firm (introducing broker-dealer or IBD) number

• officeNumber - Office number (there could be multiple office numbers per firm)

• rrCode - Advisor (investment professional, IP or registered representative) number, one for each

Practifi Setup

Presently, to complete the implementation of the Pershing Integration under Gamay your Customer Success team will need to install some final screen elements on your system.  This will be done during the set up and activation stage of your integration.  It is a once-off operation.

Contact Field Mapping

Pershing Contact Information

The following information is passed in one block to Pershing for the opening of a Draft Account:

• Primary Account Holder [from Contact, must be one]
• Additional Account Holders [from Contact, none to many]
• Address(es) of Primary Account Holder [from Account, none to two]
• Address(es) of each Additional Account Holders [from Account, none to two]
• Phone number(s) of Primary Account Holder [from Contact, none to all of Work, Home, Mobile]
• Phone Number(s) of each Additional Account Holders [from Contact, none to all of Work, Home, Mobile]

Mapping

The following table shows the mapping of Practifi UI fields to Pershing.

Practifi UI field	From	Direction	Pershing Form field	Note
First Name	Contact	🠞	First Name	For the Primary Account Holder
Last Name	Contact	🠞	Last Name	For the Primary Account Holder
Postal Street	Account	🠞	Address Line 1 (Account)	For the Primary Account Holder
Postal City	Account	🠞	City (Mailing)	For the Primary Account Holder
Postal Postcode	Account	🠞	ZIP/Postal Code (Mailing)	For the Primary Account Holder
Postal State	Account	🠞	State/Province (Mailing)	For the Primary Account Holder
Postal Country	Account	🠞	Country (Mailing)	For the Primary Account Holder
Location Street	Account	🠞	Address Line 1 (Legal)	For the Primary Account Holder
Location City	Account	🠞	City (Legal)	For the Primary Account Holder
Location Postcode	Account	🠞	ZIP/Postal Code (Legal)	For the Primary Account Holder
Location State	Account	🠞	State/Province (Legal)	For the Primary Account Holder.  If Country is CA or US, 2 letters required
Location Country	Account	🠞	Country (Legal)	For the Primary Account Holder.  Hard coded to US presently.
Gender	Contact	🠞	Gender	For the Primary Account Holder
First Name	Contact	🠞	First Name	For each Additional Account Holder
Last Name	Contact	🠞	Last Name	For each Additional Account Holder
Postal Street	Account	🠞	Address Line 1 (Mailing)	For each Additional Account Holder
Postal City	Account	🠞	City (Mailing)	For each Additional Account Holder
Postal Postcode	Account	🠞	ZIP/Postal Code (Mailing)	For each Additional Account Holder
Postal State	Account	🠞	State/Province (Mailing)	For each Additional Account Holder
Postal Country	Account	🠞	Country (Mailing)	For each Additional Account Holder
Location Street	Account	🠞	Address Line 1 (Legal)	For each Additional Account Holder
Location City	Account	🠞	City (Legal)	For each Additional Account Holder
Location Postcode	Account	🠞	ZIP/Postal Code (Legal)	For each Additional Account Holder
Location State	Account	🠞	State/Province (Legal)	For each Additional Account Holder.  If Country is CA or US, 2 letters required
Location Country	Account	🠞	Country (Legal)	For each Additional Account Holder. Hard coded to US presently.
Gender	Contact	🠞	Gender	For each Additional Account Holder
Home	Contact	🠞	Home	For each Primary and Additional Account Holders, up to three for each.
Mobile	Contact	🠞	Cell	For each Primary and Additional Account Holders, up to three for each.
Work	Contact	🠞	Work	For each Primary and Additional Account Holders, up to three for each.

 

Enabling the Integration

Enabling the Constant Contact integration with Practifi requires setting up the following configurations:

Configuration	Where
Upload Authentication Certificate	Salesforce Settings
Create Named Credential	Salesforce Settings
Create Remote Site	Salesforce Settings
Apply Advisor's rrCode	Salesforce Settings
Enable the Integration	Salesforce Settings
Schedule Sync Jobs	Salesforce Settings
Add Pershing Office Numbers	Salesforce Object Picklist update
Enable Pershing UI Items	Part of code install

Upload Authentication Certificate

One certificate needs to be uploaded.  This is a certificate which Practifi generates and requests Pershing to sign (see Before You Begin, above).  The signed certificate is held in Practifi's Keystore, and is requested by Practifi.

Once the certificate has been received from Pershing, go to Salesforce Setup under the wheel-cog icon in the top right

In Salesforce Setup, go to the Quick Find/Search bar, search for and click on Certificate and Key Management

Click on Import from Keystore

 

Select the name of the certificate received from Pershing.  The Keystore file for production access to the Pershing system for the customer will have already been received by Practifi for installation (see Before You Begin, above).  Its details, including the password, are held in bitbucket.  Click Save.

Create Named Credential

In Salesforce Setup, go to the Quick Find/Search bar, search for and click on Named Credentials

Click on New Named Credential

Supply the following:

• Label: Suggest Pershing_ Prod
• Name: <accept default>
• URL: <Production URL TBA>
• Identity Type: Named Principal
• Authentication Protocol: Password Authentication
• Username: <Production credential TBA>
• Password: <Production credential TBA>
• Generate Authorization Header: Ticked

Create Remote Sites

The Pershing Remote Site reference is set up individually within each Client Org.

In Salesforce Setup, go to the Quick Find/Search bar, search for and click on Remote Site

Click on New Remote Site

 

Supply the following:

• Remote Site Name: Suggest Pershing_Prod
• Remote Site URL:<Production URL TBA>

Click Save.

Apply Advisor's rrCode Information

This step requires the Advisor (or their IT System representative) to go to the "Advanced User Details" section of their Salesforce Settings.  

User Level

Every Advisor will be allocated by Pershing an "rrCode", which is included as part of the draft account setup process.  This value is added to the Edit Team Member panel.

Click on Edit to enable editing of the user's advanced details

 

 

 Click Save at the bottom right.  Each Advisor can apply this update to their own profiles. 

In the event this value is not set, or is not valid when the Advisor tries to create a Pershing account the following message will appear:

 

Enabling the Integration

Another set of data required relates to some defaults for opening a Draft Account.  These are set in a Custom Object.

Click Manage, then Edit.

Complete the following:

• Correspondent Number: 3CR, Issued by Pershing for the firm
• Credentials: The Name of the Named Credential (created earlier)
• Draft Acct Open Srce Code: PCOB
• Enabled: Ticked
• Base URL: <Production URL TBA>
• Request Per Batch: 20
• Verbose Logging: Ticked
• Expired Draft Account Cleanup Duration*: 90 (days)
• Draft Status: UNKN
• User Id: <the PLINK supplied by Pershing>

 

Expired Draft Account Cleanup Duration*.  If a Draft Account request has been left as a draft for this number of days, it will be deleted from the Pershing Accounts list of Accounts.  This matches Pershing’s time limits for the conversion of a Draft Account to a Full Account.

Schedule Synch Jobs

Go to the Quick Find/Search bar, search for and click on Apex Classes

Click on Schedule Apex

Look up Pershing_ScheduleSync and select as the Apex Class.  Apply the required schedule, bearing in mind the end-of-day completion jobs on the Pershing system.

 

Click Save

Add Pershing Office Numbers 

Add the list of Office Numbers (assigned to the Advisor firm by Pershing) to the list of valid office numbers for this customer.  Office Numbers are listed as a picklist on the practifi__Pershing_Account__c object, under the practifi__Office_Number__c picklist field.

Using Object Manager, navigate to Pershing Account

Navigate to Fields and Relationships, and the Office Number field

Locate the Values section, and add the required Office Numbers using the New button, and click Save when completed.

  

Enable Pershing UI Items

Assign the Practifi - Pershing permission sets to the users who need access to the Pershing Integration.
Go to Salesforce Setup, search and click Permission Sets.

Now click Practifi - Pershing.  This row will already be present.

Click Manage Assignments, and click Add Assignment.

Select Users and click Assign.

 

Access to Pershing permission will allow the users to see the following:

• List of Pershing Accounts on the integrations page and Sync Pershing Accounts button.

Note:  If Pershing is the only integration added to the Practifi system then the choice of Pershing as a dropdown choice on the Integrations tab will not appear.  The Pershing accounts will appear immediately on the mapping panel without needing to specifically select Pershing.

• Open Pershing Draft Account button on the client page.