Difference between revisions of "BillHighway"

From Online Support Wiki
Jump to navigation Jump to search
(Created page with "=Overview= Billhighway is a cloud-based platform that helps non-profits and associations manage their finances by automating all areas of their financial life-cycle. GrowthZo...")
 
 
(11 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
Billhighway is a cloud-based platform that helps non-profits and associations manage their finances by automating all areas of their financial life-cycle. GrowthZone manages membership application and renewals.  Payment for new memberships and renewals trigger communication to Billhighway. In addition, GrowthZone notifies Billhighway of changes to a member's address information (full address, phone and/or email address).
 
Billhighway is a cloud-based platform that helps non-profits and associations manage their finances by automating all areas of their financial life-cycle. GrowthZone manages membership application and renewals.  Payment for new memberships and renewals trigger communication to Billhighway. In addition, GrowthZone notifies Billhighway of changes to a member's address information (full address, phone and/or email address).
  
==Setting Up Billhighway Integration==
+
Integration to Billhighway includes:
 +
 
 +
*Ability to process payments (dues and non-dues) with ACH and credit cards using Billhighway.
 +
*Ability to process application manually or automatically and send the necessary billing/member information to Billhighway to perform the split between NAHB, State, and Local.
 +
*Ability to send changes for member information, company information updates to NAHB through Billhighway.
 +
*Ability to process renewals through GrowthZone and send to NAHB through Billhighway.
 +
 
 +
=Setting Up Billhighway Integration=
  
 
If you are new to Billhighway/GrowthZone integration, our team will assist you in ensuring the data in your GrowthZone is appropriately updated prior to performing the following setup steps.
 
If you are new to Billhighway/GrowthZone integration, our team will assist you in ensuring the data in your GrowthZone is appropriately updated prior to performing the following setup steps.
Line 9: Line 16:
 
===Billhighway Payment Processor===
 
===Billhighway Payment Processor===
  
The first step in setting up integration with Billhighway is configuring a payment processor for Billhighway.  See '''[[Billing#Setup_Billhighway_Payment_Gateway|Setup Billhighway Payment Processor]]''' for instructions on setting up the payment gateway.
+
The first step in setting up integration with Billhighway is configuring a payment processor for Billhighway. This provides the ability to process payments (dues and non-dues) with ACH and credit cards using Billhighway.  See '''[[Billing#Setup_Billhighway_Payment_Gateway|Setup Billhighway Payment Processor]]''' for instructions on setting up the payment gateway.
  
 
===Membership Types for Billhighway Integration===
 
===Membership Types for Billhighway Integration===
Line 15: Line 22:
 
When setting up Membership Types, you will select from the standard NAHB Membership types (Builder, Associate, Affiliate). See '''[[Membership_Management#Adding_a_New_Membership_Type|Adding a New Membership Type]]''' for instruction on creating your membership types.
 
When setting up Membership Types, you will select from the standard NAHB Membership types (Builder, Associate, Affiliate). See '''[[Membership_Management#Adding_a_New_Membership_Type|Adding a New Membership Type]]''' for instruction on creating your membership types.
  
'''Billhighway specific settings''':
+
====Billhighway Specific Membership Type settings====
 +
 
 +
When creating your Membership types, the '''NAHB Membership Type''' selection is only available when you have enabled a Billhighway Gateway. See [[BillHighway#Billhighway_Payment_Processor|Billhighway Payment Processor]]. If you are integrating to Billhigway, select the NAHB membership type.
  
'''NAHB Membership Type''': When creating your Membership types, the NAHB Membership Type selection is only available when you have enabled a Billhighway Gateway. If you are integrating to Billhigway, select the NAHB membership type. NOTE: Owned by should be set to organization for Builder or Associate NAHB Membership Type. Owned By should be set to Individual when selecting Affiliate NAHB Membership Type.
+
[[File:NAHB Mem Type.jpg|center]]
  
'''Billhighway specific Membership Policies settings'''
+
 
 +
 
 +
<div class='note'>'''NOTE''': The '''Owned By''' setting should be '''Organization''' for '''Builder''' or '''Associate''' NAHB Membership Type. '''Owned By''' should be set to '''Individual''' when selecting '''Affiliate''' NAHB Membership Type.</div>
 +
 
 +
====Billhighway specific Membership Policies settings====
  
 
In order for the Bilhighway/GrowthZone integration to work, certain data needs to be collected at the time a membership is added. To ensure that the required data is gathered during the application process, the following fields should be set to required within the '''Membership Policies''':
 
In order for the Bilhighway/GrowthZone integration to work, certain data needs to be collected at the time a membership is added. To ensure that the required data is gathered during the application process, the following fields should be set to required within the '''Membership Policies''':
Line 32: Line 45:
 
In addition, if categories are used, category selection should also be enabled within the '''Membership Policies'''.
 
In addition, if categories are used, category selection should also be enabled within the '''Membership Policies'''.
  
==Bill Highway Membership Application Processing==
+
=Billhighway Membership Application Processing=
  
 
The Membership Application form must not be set to '''Automatically Approve Applications''', all applications must be reviewed and approved by your internal staff.   
 
The Membership Application form must not be set to '''Automatically Approve Applications''', all applications must be reviewed and approved by your internal staff.   
 
#Membership application will get submitted and go in '''Pending Approval''' status.
 
#Membership application will get submitted and go in '''Pending Approval''' status.
#'''IF''' the applicant has selecte "Pay Now", once your staff has reviewed and approved the application, new membership information is sent Billhighway.  
+
#'''IF''' the applicant has selected "Pay Now", once your staff has reviewed and approved the application, new membership information is sent Billhighway.  
 
#:'''OR'''
 
#:'''OR'''
 
#'''IF''' the applicant selected "Invoice Me", your staff must review and approve the application. Once the member pays for the membership, the new membership information is sent to Billhighway.
 
#'''IF''' the applicant selected "Invoice Me", your staff must review and approve the application. Once the member pays for the membership, the new membership information is sent to Billhighway.
  
 
See '''[[Membership_Management#Approving_On-line_Membership_Applications|Approving On-line Application Forms]]''' for information on processing/approving applications.
 
See '''[[Membership_Management#Approving_On-line_Membership_Applications|Approving On-line Application Forms]]''' for information on processing/approving applications.
 +
 +
Once the new membership information has been sent to NAHB, NAHB will return:
 +
 +
*'''COID''': This is the NAHB Company ID for an organization, and is stored in the '''Account Name''' for the organization.
 +
*'''PIN''': This is an individual contact id, and is stored in the '''Account Name''' field for an individual contact.
 +
*'''MSN''': This is the membership subscription number, and is stored on the membership details screen.
 +
 +
 +
 +
<div class='note'>'''NOTE:''' Return of these IDs could be on a 5 to 10 minute delay, but once received will automatically update the Contact records and Memberships accordingly.</div>
 +
 +
==Billhighway Adding Membership from Back-office==
 +
 +
Best Practice for entering a new member from the back-office is by accessing the on-line application form. However, if you do choose to enter the new member through the database, you must ensure that the following is completed for the organization/individual:
 +
 +
*Full Address (address 1, city, state, zip, country) and address type
 +
*Individual Email address
 +
*Organization Business Activity
 +
 +
See '''[[Membership_Management#Adding_a_Membership_to_a_Contact|Adding a Membership to a Contact]]''' for instructions.
 +
 +
<div class='note'>'''NOTE''': When a membership is added from the back-office, information is '''NOT''' sent to Billhighway until the member has paid for the membership.</div>
 +
 +
=Billhighway - Processing Membership Renewals=
 +
 +
When renewal invoices are paid, the system will automatically push the member and paid invoice information to Billhighway. "Renewal Invoices" are invoices that include goods/services of type '''Membership Dues''', are tied to a '''Membership Type''' and the member has an MSN and PIN. NAHB will automatically drop a member who has not renewed by their renewal date. No notification is sent to GrowthZone when NAHB processes the drop, so you will want to play close attention to your member renewal due dates. In the event the renewal is not paid by the expiration date:
 +
 +
'''Scenario #1''': The member is '''Active''' in GrowthZone, has not paid their invoice by the renewal date (therefore has been dropped by NAHB), but wishes to renew.  If the invoice is open, accept payment for the invoice.  GrowthZone will send this information to NAHB. NAHB will see this as a new membership, and send back a new MSN and PIN for the member/contact.
 +
 +
'''Scenario #2''': The Member is '''Active''' in GrowthZone, has not paid their invoice by the renewal date (therefore has been dropped by NAHB), and you have written off the invoice. The member must re-apply on-line '''OR''' you can re-activate their membership in the back-office. GrowthZone will send this information to NAHB. NAHB will see this as a new membership, and send back a new MSN and PIN.
 +
 +
'''Scenario #3''': The Member is '''Dropped''' in GrowthZone, and wishes to renew their membership. The Member may re-apply on-line '''OR''' you can re-activate the membership in the back-office (See '''[[Membership_Management#Reactivate_Membership|Reactivate a Membership]]'''). Once the member has paid the membership invoice, information will be sent to NAHB, and NAHB will send back new MSN and PIN information.
 +
 +
=Bill Highway Member Information Updates=
 +
 +
Information (both individual or company) changes may be updated within GrowthZone. GrowthZone runs a process every ten minutes to determine if changes have been made to:
 +
 +
'''Individual Contact Records'''
 +
*First name
 +
*Last name
 +
*Full Address (the one marked as Default in GrowthZone)
 +
*Email address (the one marked as Default in GrowthZone)
 +
*Phone number (the one marked as Default in GrowthZone)
 +
 +
'''Organization Contact Records'''
 +
*Company Name
 +
*Full Address (the one marked as Default in GrowthZone)
 +
*Phone number (the one marked as Default in GrowthZone)
 +
*Email (the one marked as Default in GrowthZone)
 +
 +
'''Custom Fields'''
 +
*Dollar Volume
 +
*Units Started
 +
 +
If GrowthZone identifies information that has been updated, GrowthZone will send the updated information to Billhighway.

Latest revision as of 21:48, 5 July 2018

Overview

Billhighway is a cloud-based platform that helps non-profits and associations manage their finances by automating all areas of their financial life-cycle. GrowthZone manages membership application and renewals. Payment for new memberships and renewals trigger communication to Billhighway. In addition, GrowthZone notifies Billhighway of changes to a member's address information (full address, phone and/or email address).

Integration to Billhighway includes:

  • Ability to process payments (dues and non-dues) with ACH and credit cards using Billhighway.
  • Ability to process application manually or automatically and send the necessary billing/member information to Billhighway to perform the split between NAHB, State, and Local.
  • Ability to send changes for member information, company information updates to NAHB through Billhighway.
  • Ability to process renewals through GrowthZone and send to NAHB through Billhighway.

Setting Up Billhighway Integration

If you are new to Billhighway/GrowthZone integration, our team will assist you in ensuring the data in your GrowthZone is appropriately updated prior to performing the following setup steps.

Billhighway Payment Processor

The first step in setting up integration with Billhighway is configuring a payment processor for Billhighway. This provides the ability to process payments (dues and non-dues) with ACH and credit cards using Billhighway. See Setup Billhighway Payment Processor for instructions on setting up the payment gateway.

Membership Types for Billhighway Integration

When setting up Membership Types, you will select from the standard NAHB Membership types (Builder, Associate, Affiliate). See Adding a New Membership Type for instruction on creating your membership types.

Billhighway Specific Membership Type settings

When creating your Membership types, the NAHB Membership Type selection is only available when you have enabled a Billhighway Gateway. See Billhighway Payment Processor. If you are integrating to Billhigway, select the NAHB membership type.

NAHB Mem Type.jpg


NOTE: The Owned By setting should be Organization for Builder or Associate NAHB Membership Type. Owned By should be set to Individual when selecting Affiliate NAHB Membership Type.

Billhighway specific Membership Policies settings

In order for the Bilhighway/GrowthZone integration to work, certain data needs to be collected at the time a membership is added. To ensure that the required data is gathered during the application process, the following fields should be set to required within the Membership Policies:

  • Individual Mailing Address
  • Individual Address Country
  • Business Mailing Address
  • Business Address Country

The Billhighway integration requires GrowthZone to send these parameters in order for the information to be successfully received by Billhighway. See Understanding Membership Policies for details on setting up standard questions for the application form.

In addition, if categories are used, category selection should also be enabled within the Membership Policies.

Billhighway Membership Application Processing

The Membership Application form must not be set to Automatically Approve Applications, all applications must be reviewed and approved by your internal staff.

  1. Membership application will get submitted and go in Pending Approval status.
  2. IF the applicant has selected "Pay Now", once your staff has reviewed and approved the application, new membership information is sent Billhighway.
    OR
  3. IF the applicant selected "Invoice Me", your staff must review and approve the application. Once the member pays for the membership, the new membership information is sent to Billhighway.

See Approving On-line Application Forms for information on processing/approving applications.

Once the new membership information has been sent to NAHB, NAHB will return:

  • COID: This is the NAHB Company ID for an organization, and is stored in the Account Name for the organization.
  • PIN: This is an individual contact id, and is stored in the Account Name field for an individual contact.
  • MSN: This is the membership subscription number, and is stored on the membership details screen.


NOTE: Return of these IDs could be on a 5 to 10 minute delay, but once received will automatically update the Contact records and Memberships accordingly.

Billhighway Adding Membership from Back-office

Best Practice for entering a new member from the back-office is by accessing the on-line application form. However, if you do choose to enter the new member through the database, you must ensure that the following is completed for the organization/individual:

  • Full Address (address 1, city, state, zip, country) and address type
  • Individual Email address
  • Organization Business Activity

See Adding a Membership to a Contact for instructions.

NOTE: When a membership is added from the back-office, information is NOT sent to Billhighway until the member has paid for the membership.

Billhighway - Processing Membership Renewals

When renewal invoices are paid, the system will automatically push the member and paid invoice information to Billhighway. "Renewal Invoices" are invoices that include goods/services of type Membership Dues, are tied to a Membership Type and the member has an MSN and PIN. NAHB will automatically drop a member who has not renewed by their renewal date. No notification is sent to GrowthZone when NAHB processes the drop, so you will want to play close attention to your member renewal due dates. In the event the renewal is not paid by the expiration date:

Scenario #1: The member is Active in GrowthZone, has not paid their invoice by the renewal date (therefore has been dropped by NAHB), but wishes to renew. If the invoice is open, accept payment for the invoice. GrowthZone will send this information to NAHB. NAHB will see this as a new membership, and send back a new MSN and PIN for the member/contact.

Scenario #2: The Member is Active in GrowthZone, has not paid their invoice by the renewal date (therefore has been dropped by NAHB), and you have written off the invoice. The member must re-apply on-line OR you can re-activate their membership in the back-office. GrowthZone will send this information to NAHB. NAHB will see this as a new membership, and send back a new MSN and PIN.

Scenario #3: The Member is Dropped in GrowthZone, and wishes to renew their membership. The Member may re-apply on-line OR you can re-activate the membership in the back-office (See Reactivate a Membership). Once the member has paid the membership invoice, information will be sent to NAHB, and NAHB will send back new MSN and PIN information.

Bill Highway Member Information Updates

Information (both individual or company) changes may be updated within GrowthZone. GrowthZone runs a process every ten minutes to determine if changes have been made to:

Individual Contact Records

  • First name
  • Last name
  • Full Address (the one marked as Default in GrowthZone)
  • Email address (the one marked as Default in GrowthZone)
  • Phone number (the one marked as Default in GrowthZone)

Organization Contact Records

  • Company Name
  • Full Address (the one marked as Default in GrowthZone)
  • Phone number (the one marked as Default in GrowthZone)
  • Email (the one marked as Default in GrowthZone)

Custom Fields

  • Dollar Volume
  • Units Started

If GrowthZone identifies information that has been updated, GrowthZone will send the updated information to Billhighway.