Skip to content

Backbase/fiserv-integration-bill-pay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fiserv Integration Service demo for Backbase Bill Pay DBS Service

This service enables you to integrate the Bill Pay DBS capability with Fiserv to:

  • Enrol
  • Find new payees to pay
  • Manage your payees
  • Manage your payments
  • Retrieve your Bill Pay accounts
  • Retrieve and file your eBills

This service is based upon the guide: https://community.backbase.com/documentation/DBS/latest/bill_pay_integration_microservice

We ❤️ Feedback!

Ever heard of feedbackware? Well, we have a little proposition for you...

Write to [email protected] telling us how you're using this connector and we'll send you some free goodies through the post all the way from Cardiff, Wales (where the connector was written).

Let us know what you DO and DON'T like about the connector; what you DO and DON'T like about our Bill Pay product; how you think we could improve; who you work for; how you're using Bill Pay; anything else you think we should know; and of course, your delivery address... We'll then get some goodies sent through the post to you :-)

This offer is limited to 1 goodie bag per company, and we reserve the right to remove the promotion at any time.

Components

Fiserv Bill Pay Integration Service

Component that makes the actual integration with Fiserv API.

Check the Configuration section for more details

Installation

Prerequisites

  • JDK 1.8 (PSU >= 131 if using Docker)
  • Apache ActiveMQ 5.14
  • Apache Maven

Check community for more details: https://community.backbase.com/documentation/ServiceSDK/latest/deploy_developer_environment

for more details of how to run a custom service: https://community.backbase.com/documentation/ServiceSDK/latest/deploy_custom_services

Configure

The following properties have to be set and obtained from your Fiserv account.

backbase:
  billpay: 
    provider:
      url: 
      clientAppText: 
      clientAppVersion: 
      sponsorId: 

These properties can be set as environment properties.

java -jar fiserv-integration-bill-pay-x.x.x-boot.war -DSIG_SECRET_KEY=**** \
    -Dbackbase.billpay.provider.url=**** \
    -Dbackbase.billpay.provider.clientAppText=**** \
    -Dbackbase.billpay.provider.clientAppVersion=**** \
    -Dbackbase.billpay.provider.sponsorId=**** 

Build

Build all the artifacts and install it by running the following command

   mvn clean install

Getting Started

Required Environment Properties

Set the following properties (some properties can be updated in src/main/resources/application.yml):

  • SIG_SECRET_KEY: Key for signing internal token (The secret length must be at least 256 bits)
  • SPRING_ACTIVEMQ_BROKER_URL: url of the apache MQ
  • SPRING_ACTIVEMQ_USER: user of apache MQ
  • SPRING_ACTIVEMQ_PASSWORD: password of apache MQ

To run the service in development mode, use:

mvn spring-boot:run

To run the service from the built binaries, use:

java -jar fiserv-integration-bill-pay-x.x.x-boot.war -DSIG_SECRET_KEY=**** \
    -Dbackbase.billpay.provider.url=**** \
    -Dbackbase.billpay.provider.clientAppText=**** \
    -Dbackbase.billpay.provider.clientAppVersion=**** \
    -Dbackbase.billpay.provider.sponsorId=**** 

The binaries can run in web containers such as:

  • Apache Tomcat 8 (Tested)
  • IBM Liberty Profile (Not Tested)
  • Wildfly

Known Issues

  • The FiservClient.initiateSession code is not currently utilised, it should be incorporated via a caching solution.

Next Steps

License

Copyright (c) 2018 Backbase B.V.

This Backbase License Agreement (“Agreement”) sets forth the terms and conditions of Your use of the Software that is provided together with this license. If You continue to download the Software, You agree that Your use of the Software, and the use of the Software by any natural or legal person you distribute the Software to, will be covered by this license Agreement. Any third party software that is provided with the Software is included for use at Your option subject to the terms of the license applicable to that software. If You choose to use such software, then such use shall be governed by such third party's license agreement (See Annex A to these terms for an overview of third party software) and not by this Agreement.

  1. Definitions

1.1 “Backbase” shall mean Backbase Europe BV, whose place of business is at the INIT Building, Jacob Bontiusplaats 9, 1018 LL Amsterdam, The Netherlands.

1.2 “Documentation” means all online help files or written instruction manuals regarding the Software.

1.3 “Derivative Works” shall mean any Software, whether in source or object form, that is based on (or derived from) the Software and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship.

1.4 “Licensee” or “You” means the individual who downloads the Software and, if you are downloading the Software to be used for or on behalf of a legal entity, the entity on behalf of which you are downloading the Software.

1.5 “Software” means the object code of the computer program(s) Licensee has downloaded and includes any Documentation as provided.

  1. Grant of Rights and Restrictions

2.1 License Grant. Backbase grants to Licensee a non-exclusive, non-transferable right and license to: (a) reproduce, modify and prepare Derivative Works of the Software, and (b) use the Software and Derivative Works for its own internal use and, subject to the conditions in section 2.2, distribute the Software and such Derivative Works as an integrated part of commercial products that Licensee makes available on the market (e.g. mobile apps). Any other form of distribution or reselling the Software is not permitted. Except for the express license granted in this Section 2.1, no other licenses are granted.

2.2 Redistribution. Licensee may distribute the Software and such Derivative Works as an integrated part of commercial products Licensee makes available on the market, provided that Licensee meets the following conditions:

a) Licensee must provide any other recipients to whom it distributes the Software or Derivative Works to, with reasonable notice of these terms and the applicability thereof to the use of the Software. Moreover, Licensee shall require such recipients to agree to the terms of this Agreement including its annexes before making the Software available for download; and b) Licensee must retain in the Software and Derivative Works any “NOTICE” text files (where such notices normally appear) and all copyright, patent, and trademark notices excluding those notices that do not pertain to any part of the Derivative Works. Contents of the NOTICE file are for informational purposes only and do not modify the License.

c) This License does not grant any rights in the patents, trademarks, service marks, or logos of Backbase (except as may be necessary to comply with the notice requirements in Section 2.2).

  1. Warranty Disclaimer and Limitation of Liability

THE SOFTWARE IS PROVIDED ON AN "AS IS", ‘WHERE IS” BASIS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS BORNE BY LICENSEE. IN NO EVENT SHALL BACKBASE BE LIABLE, NOR SHALL LICENSEE HOLD BACKBASE LIABLE, FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, ARISING FROM THE USE OR DISTRIBUTION OF THE SOFTWARE. THIS SECTION 3 CONSTITUTES AN ESSENTIAL PART OF THIS AGREEMENT. THE SOFTWARE MAY NOT BE USED HEREUNDER EXCEPT UNDER THIS DISCLAIMER AND LIMITATION OF LIABILITY.

  1. Indemnification by Licensee

Licensee shall defend, indemnify and hold harmless Backbase and its officers, directors, employees and shareholders from and against any and all loss, damage, settlement, costs or expense (including legal expenses and expenses of other professionals), as incurred, resulting from, or arising out of any third party claim which alleges that a Derivative Work infringes upon, misappropriates or violates any intellectual property rights, where such claim is independent of the Software.

  1. Applicable Law and Jurisdiction

This Agreement is governed by and interpreted in accordance with the laws of the Netherlands, and Licensee hereby consents to the exclusive jurisdiction and venue of the District Court of Amsterdam.