November 2016 Release Notes

Note: Update the various environments (Stage, Developer Sandbox, Production) are rolled out in different upgrade windows. Please consult with Solution Engineer (for stage), Client/Support (for production) to get exact date-time of upgrade.

New Features and Enhancements Summary

  1. The following services have been introduced as part of YSL:
    1. Matching service and challenge deposit verification (CDV) services.
    2. Get verification status to learn the status of CDV.
  2.   The following are the enhancements made to existing services as part of this release:
    1. Get providers and get provider details services now provide the following fields in the response:
      1. isAutoRefreshEnabled
      2. numberOfTransactionDays
      3. additionalDataset
    2. isAutoRefreshEnabled indicates if a provider site is refreshed automatically or every two weeks.

    3. numberOfTransasctionDays indicates the total number of days for which transactions can be fetched for a particular provider site.

    4. additionalDataset has been introduced as a filter in the get providers service to filter the providers.
    5. Add & Update providerAccount services retrieve to aggregate additional data sets while adding or updating accounts.
    6. Holding Summary service provides the following fields in the response:
      1. securityType
      2. matchStatus
    7. securityType indicates the security type of holding identified through the security service
    8. matchStatus has been introduced to indicate the security match status id of the investment option identified during security normalization.
    9. Add account service under providerAccount is enhanced to accept the include attribute for Instant Account Verification.
    10. Get Accounts and Get accounts summary are enhanced to provide additional attributes
      1. AccountNumber
      2. holderName
      3. bankTransferCode

New API Details

End point

 Details
 

PUT /{cobrandName}/ v1/providerAccounts/ verification

  

 Performs matching or CDV.

  

GET /{cobrandName}/ v1/providerAccounts/verification/{providerAccountId}

 

Gets the status of CDV

 

Existing APIs Enhancement Details

Endpoint

Enhancement Details

 

GET /{cobrandName}/v1/providers

GET /{cobrandName}/v1/providers/{providerId}

 

The services now provide the following parameters in the response:

  1. isAutoRefreshEnabled
  2. numberOfTransactionDays
  3. additionalDataset

GET /{cobrandName}/v1/holdings

GET /{cobrandName}/v1/derived/holdingSummary

The services have been enhanced to provide the following parameters in the response:

  1. securityType
  2. matchStatus

(refer Appendix)
 

GET /{cobrandName}/v1/providers

 

1. Capability field has been introduced in the response to indicate CDV enabled providers.
2. Capability field has been added as a query parameter

 

Known Issues/ Bugs

Data type of providerId is an integer. The get accounts and get account details services have been providing the providerId as a string and not as an integer. This is on track to be fixed as part of the December 2016 release. We’re asking customers to take actions to ensure the implementation works while we upgrade our APIs.

Appendix

The following are the new security type values.

SNO

Security Type

1

MORTGAGE_BACKED_SECURITY

2

CLOSE_ENDED_FUND

3

PEER_TO_PEER_LOAN

4

RESTRICTED_STOCK_UNIT

5

RESTRICTED_STOCK_AWARD

6

AMERICAN_DEPOSITORY_RECEIPT

7

AGENCY_BOND

8

ANNUITY_FUND

9

CORPORATE_BOND

10

CERTIFICATE_OF_DEPOSIT

11

COMMON_STOCK

12

EXCHANGE_TRADED_FUND

13

EMPLOYEE_STOCK_OPTION

14

HEDGE_FUND

15

LIMITED_PARTNERSHIP

16

MONEY_MARKET_FUND

17

MUNICIPAL_BOND

18

MUTUAL_FUND

19

PREFERRED_STOCK

20

PRIVATE_EQUITY

21

REAL_ESTATE_INVESTMENT_TRUST

22

RIGHT

23

SWAP

24

US_TREASURY

25

UNIT_INVESTMENT_TRUST

26

WARRANT

27

BOND

28

OTHER

29

CASH

30

COMMODITY

31

CURRENCY

32

FUTURE_CONTRACT

33

OPTION