Administrative APIs | REST

Version:
Download Open API Specification

Get Plan Interest Bearing Settings

https://api.wealthcare.com/system/Services/Plan/PlanInterestBearingSetting/{tpaId}/{employerId}/List

Use this operation to retrieve the interest bearing settings for all plans under a specified employer.

  • tpaId string Required

    A unique identifier used to identify your admin instance. This value was system generated with the admin instance was created.

  • employerId string Required

    Unique identifier for the employer. Note: When the employer was created, WealthCare Admin assigned the 3-character prefix; you assigned the remaining characters.

  • array <object>
    • TpaId string Required

      A unique identifer for your administrator instance, generated by WCA when the instance was first set up. If a value is not sent, the TPA ID from the user making the request with be used.

    • EmployerId string

      Unique identifier for the employer. Note: When the employer was created, WealthCare Admin assigned the 3-character prefix; you assigned the remaining characters.

    • PlanId string

      Unique identifier that distinguishes this plan from all others you administer.

    • PlanAccountTypeCode string

      Three character abbreviation that indicates the type of account (FSA, DCA, TRN, HRA, etc.)

    • PlanYearStartDate string

      (YYYMMDD)Date that funds are available for services.

    • PlanYearEndDate string

      (YYYMMDD)Date after which services are not eligible for payment, unless there is an extension in the field.

    • ProductPartnerAdminId string

      The Product Partner Administrator ID assigned to you by your product partner system, which is used by your product partner to uniquely identify accounts which are to be associated with your book of business in their system.

    • InterestBearingIndicator boolean

      Indicates whether interest is to be accrued for this employee account. If this is set to “0” for an interest bearing account that previously accrued interest, Interest will be paid up to the Interest Close Date provided.

      Note: When setting up an existing account as “Yes=1” for interest bearing and the account has transaction history and balances, it is recommended to only activate this feature on the first of the next Interest Payment Cycle. The Transaction History and prior balances will not accrue interest. Interest will only be accrued going forward or for an subsequently back-dated transactions.

      The values available are: 0 = No longer bear interest 1 = Bear interest The default of this field if it is not filled in is 0.

      Note: This will not be implemented on HSA plan types.

    • AllowOverrideAccountLevel boolean

      This field is used to indicate whether or not to allow interest override at the employee account level. If an update is made at the employee account level, then the employee account will no longer inherit any updates made at the employer plan level.

      The values available are:

      0 = Do not allow interest override at the account level.

      1 = Allow interest override at the account level.

      Note**: If “Interest Indicator” is 1 then this field is required.

    • ReaccrueInterestThisPaymentCycleIndicator boolean

      This field is used to define whether or not this account should reaccrue interest for this payment cycle. When an account’s Interest Plan ID or Payment Cycle ID is assigned or updated, this field must be provided. The default is no = 0. A “1” (Reaccrue Interest) means interest should be reaccrued for the accrual period to date using the new Interest Plan. “No” means accrued interest period to date remains as is and is not reaccrued. Note: any subsequent back-dated deposits will accrue interest in accordance with the new interest plan.

      The values available are: 0 = Do not reaccrue interest for this payment cycle. 1 = Reaccrue interest for this payment cycle.

      The default of this field it is not filled in is 0.

      Note**: If “Interest Indicator” is 1 then this field is required.

    • InterestPlanId string

      This field is the interest plan ID. If this is assigned or updated mid-payment cycle, then the interest will be accrued according to the new Interest Plan ID going forward. Any back-dated deposits subsequently received will accrue according to this new Interest Plan.

      Note**: If “Interest Bearing Indicator” is 1 then this field is required.

    • InterestCycleId string

      This field must match the an Interest Payment Cycle ID in WCA – otherwise the record will be rejected and no changes made to the Interest Plan settings..

      Note**: If “Interest Bearing Indicator” is 1 then this field is required.

    • InterestEndDte string
    • TargetPlanId string

      The Plan ID for the account to which accrued interest from the source account should be paid. If this field is left blank interest will be paid in accordance with the Employer Plan interest plan setting.

      Note 1: The concatenation of Plan ID, Account Type, Start Date, and End Date must be unique for each plan for this employer. All data must be provided for those fields or all must be left blank.

      Note 2: The target account must be a new, active, temporarily inactive or terminated.

    • TargetPlanAccountTypeCode string

      This field is the target plan Account Type Code. Use this field in combination with other Target plan information to pay interest to another account.

      Type of benefit plan or account, such as FSA, DCA, or TRN. If a target plan is not provided the interest will be paid to the sourced plan.

      Note: The target plan must be a new, active, or temporarily active Employer plan.

    • TargetPlanYearStartDate string

      The Plan Start Date for the account to which accrued interest from the source account should be paid. If this field is left blank interest will be paid in accordance with the Employer Plan interest plan setting.

      Note 1: The concatenation of Plan ID, Account Type, Start Date, and End Date represents the employee account. All data must be provided for those fields to update interest target account or all must be left blank to default to Plan or leave as is.

      Note 2: The target account must be a new, active, temporarily inactive or terminated.

    • TargetPlanYearEndDate string

      The Plan End Date for the account to which accrued interest from the source account should be paid. If this field is left blank interest will be paid in accordance with the Employer Plan interest plan setting.

      Note 1: The concatenation of Plan ID, Account Type, Start Date, and End Date represents the employee account. All data must be provided for those fields to update interest target account or all must be left blank to default to Plan or leave as is.

      Note 2: The target account must be a new, active, temporarily inactive or terminated.