Name: real-time-payments
Owner: International Business Machines
Description: Code for a Developer Journey that uses the Financial APIs on Bluemix. This application uses this service to send and request payments.
Created: 2017-08-29 19:05:34.0
Updated: 2018-05-07 05:39:11.0
Pushed: 2018-04-27 19:01:18.0
Homepage: https://real-time-payments-app.mybluemix.net
Size: 1348
Language: JavaScript
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
In this code pattern, we will use a Bluemix finance service to create a web application which sends and requests payments. The Real-Time Payments service is used to manage tokens and recipients, and to initiate payments and payment requests.
The application presents an online banking experience, starting with getting a user to create an account. A user's sample bank account is created with a checking and savings account. In order for user to start making payments, the user is requested to register an email or phone number as their token for their checking or savings account. After completing this step, the user can send or request payments to another user's account using their token such as phone number or email. All user activities are recorded and can be displayed to the user.
When the reader has completed this code pattern, they will understand how to:
Log in to your IBM Cloud account before deploying. If already logged in, then ignore this step.
We can see that the app is ready to be deployed. Provide an App name to your application and ensure that the Region, Organization and Space is valid before pressing 'Deploy'.
In Toolchain, the app is deployed. There are also options to edit code via eclipseIDE, git changes if required.
You should see two stages pass successfully once your Deploy Stage completes
To see the app and services created and configured for this pattern, use the IBM Cloud dashboard
Follow these steps to setup and run this code pattern. The steps are described in detail below.
Clone the Real Time Payments locally. In a terminal, run:
$ git clone https://github.com/IBM/real-time-payments.git
Create the following services:
Edit the manifest.yml file in the folder that contains your code and replace my-real-time-payments-app with a unique name for your application. Additional - update the service name so they match what you have in IBM Cloud. The relevant portion of the manifest.yml file looks like the following:
ared-services:
{Real-Time-Payments}:
label: real-time-payments-service
plan: real-time-payments-service-free-plan
ications:
me: {my-real-time-payments-app}
ndom-route: true
mory: 128M
rvices:
- {Real-Time-Payments}
v:
NODE_TLS_REJECT_UNAUTHORIZED: 0
Create a .env file in the root directory of your clone of the project repository by copying the sample .env.example file using the following command:
NOTE Most files systems regard files with a “.” at the front as hidden files. If you are on a Windows system, you should be able to use either GitBash or Xcopy
env.example .env
You will need to update the credentials with Real-time payments service access token:
al-time Payments
_REAL_TIME_PAYMENTS_URL=https://ftm-proxy.mybluemix.net
_SIMULATED_INSTRUMENT_ANALYTICS_ACCESSTOKEN=
cd into this project's root directory
npm install to install the app's dependenciesrunme.shThe application emulates a bank's online web or mobile portal. Using your favorite browser, launch the application and choose “i'm new here”. Enter a first name, last name, user name and any password.
If the specified user name exists, the user will be redirected to the standard login process. Otherwise the application will create two new accounts, checking and savings, by calling the 'core banking system' database, and put some money in each account. The application will also create a Participant by calling FTM's CXCParticipant (POST) API.
Assume John Doe is a customer of the bank.
The application displays a list of John's accounts - checking and savings - and the balance of each. This information is retrieved from the 'core banking system' database.
The application has an option to “send or receive money”.
A list of John's tokens is displayed. This information is pulled from FTM?s CXCToken API (GET). Clicking on one of them allows John to view/edit the 'contact info', and select from a list of his accounts (pulled from the 'core banking system' database). A legal disclaimer is displayed with a checkbox to indicate acceptance. Clicking Continue produces a confirmation page and then clicking “Add email/mobile #” invokes FTM's CXCToken API (POST). John can also ?Edit? the token using FTM's CXCToken API (PUT), or “Delete” the token, and after the “are you sure ?” check, FTM's CXCToken API (DELETE) is invoked.
John may “Add another email/mobile #“. The 'contact info' field is free text, the 'deposit account' is a list of his accounts (pulled from the 'core banking system' database). A legal disclaimer is displayed with a checkbox to indicate acceptance. Clicking Continue produces a confirmation page and then clicking “Add email/mobile #” invokes FTM's CXCToken API (POST).
Next John selects “Add Recipients”.
A list of John's recipients is displayed. This information is pulled from FTM?s CXCRecipient API (GET). Clicking on one of them allows John to view/edit the 'recipient details'. Details are pulled from FTM?s CXCRecipient API (GET). John may “Add New Recipient”. The “Mobile # or Email”, “First Name”, and “Last Name” fields are free text. Clicking Continue produces a confirmation page and then clicking “Add recipient” invokes FTM's CXCRecipient API (POST). John can also can also ?Edit? the recipient using FTM's CXCRecipient API (PUT), or “Delete” the recipient, and after the “are you sure ?” check, FTM's CXCRecipient API (DELETE) is invoked.
He can either choose a recipient from a list, pulled from FTM's CXCRecipient API (GET), or enter an email/mobile # manually. The next screen prompts him for the amount (in $USD), and a list of his source accounts, pulled from FTM's CXCToken API (GET). Clicking 'continue' gives a confirmation screen and then clicking “Send” invokes FTM's CXCPayment API (POST). FTM debits the selected amount from John's account by calling back into the 'core banking system' database. FTM notifies the recipient via email (or sms) by calling a User Exit.
He can either choose a recipient from a list, pulled from FTM's CXCRecipient API (GET), or enter an email/mobile # manually. The next screen prompts him for the amount (in $USD), and a list of his deposit accounts, pulled from FTM's CXCToken API (GET). Clicking 'continue' gives a confirmation screen and then clicking “Request” invokes FTM's CXCPaymentRequest API (POST). FTM notifies the requestee via email (or sms) by calling a User Exit.
John can then choose “View Activity”.
A list of statii is given (Accepted, Completed, Delivered, Expired, Failed, Pending, Sent). Each of those can be chosen, and a list of payments in that status is given, pulled from CXCPayment and CXCPaymentRequest APIs (GET). Each selected transaction can be viewed, the data is pulled from the CXCPayment or CXCPaymentRequest API (GET).
John logs out of the application.
Using a web browser, he logs onto the BlueMix Console and navigates to the FTM for Real Time Payments APIs. His user name, password and API Key are verified by the API Proxy which maintains a secret username and password to use with FTM?s REST API.
He can explore FTM?s core read-only APIs and he chooses to view inboundTransactions (GET).
Find more information on FTM for Real Time Payments api calls here.
Billy logs out of BlueMix.
ogs <application-name> --recent