---
schema_version: "1"
id: af5aac4bccbc36e0319a508e4da6e7fb73e9515d8926eb7a5fd4100aefbf0163
title: Payments Modernization Demo Setup Guide
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/financial-services/latest/payments-setup-guide.md
canonical_url: https://docs.mulesoft.com/financial-services/latest/payments-setup-guide
source_site: docs.mulesoft.com
content_type: documentation
content_hash: d93622bccea1f9854f40a775b787505668486380a46c439184d565069b72f6d8
description: MuleSoft Documentation Site
release: "1.12"
latest: true
---
---
product: Financial Services
version: 1.12
is-latest-version: true
---

# Payments Modernization Demo Setup Guide

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

This guide provides instructions for setting up all the components required to run the Payments
Modernization use case demo.

## Summary

- A Docker runtime will be required to deploy containers needed by the solution

- A generic core banking system will be used as the primary system of record

- Moov.io containers will be used to simulate the processing of ACH and Fedwire messages

- A third-party Java library will be used to simulate the processing of SWIFT messages

- A custom process will be used to simulate incoming payment confirmations

- A
  [Payments Front-end Web UI](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-payments-frontend-webui-src/)
  has been built to demonstrate the functionality implemented by this use case

- MultiChain Wallet Node is used to support processing of BlockChain Transactions

## Setup

This guide sets up a demo environment with the supported backend services used by the provided API
implementations. When these APIs are adopted by a MuleSoft customer, it is expected that the
customer will replace these example backend services with their preferred services.

The following containerized services are deployed on docker. For demo purposes, it is recommended to
deploy all containers on a single Docker node.

- moov.io ACH service

- moov.io Fedwire service

- [Payments Front-end Web UI](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-payments-frontend-webui-src/)

- Blockchain based on [MultiChain](https://www.multichain.com/)

The
[Payments Front-end Web UI](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-payments-frontend-webui-src/)
can also be run locally, outside of a container, by following the instructions provided in its
README file.

**Payments Front-end Web UI recommended setup:**

1.  Install Docker and its dependencies on the server of your choice.

2.  Configure the
    [Payments Front-end Web UI](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-payments-frontend-webui-src/)
    by modifying the following properties in the .env file:

    - `REACT_APP_PAYMENTS_WEBUI_EXP_API_ENDPOINT` should point to an instance of the
      [Payments Web UI Experience API](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-payments-webui-exp-api-spec/)

    - `REACT_APP_PAYMENTS_WEBUI_EXP_API_WEBSOCKET_ENDPOINT` should point to an instance of the
      [Payments Web UI Experience API](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-payments-webui-exp-api-spec/)

3.  Build the docker image by running its docker-build.sh script.

4.  Start the docker container by running the docker-run.sh script on the machine running the Docker
    server, or use a Docker administration UI to manage the containers.

5.  Update `https.cors.allow-url` property in the
    [Payments Web UI Experience API](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-payments-webui-exp-api/)
    with the Payments Front-end Web UI endpoint to allow CORS.

**Moov.io recommended setup:**

The moov.io images are provided pre-built as-is. They can be started on the Docker server by using
the included docker-run.sh scripts.

**MultiChain setup:**

To run the MultiChain node as a docker container, perform the following steps:

1.  Use the Dockerfile from the scripts folder in the
    [Blockchain System API](https://anypoint.mulesoft.com/exchange/org.mule.examples/fins-blockchain-sys-api-spec/)
    to build the MultiChain image.

2.  Run the `docker-run.sh` script to deploy the container and setup network ports. Run
    `docker-exec.sh` to create MultiChain and configure the json-rpc service to interact with the
    MultiChain container.

## See Also

- [Prerequisites](https://docs.mulesoft.com/financial-services/latest/prerequisites)

- [MuleSoft Accelerator for Financial Services](https://docs.mulesoft.com/financial-services/latest/)