This is a gRPC service used to create and manage user payment records and transactions.
This gRPC service requires the following software:
- NodeJS version 18 or higher.
- Informix database.
- Yarn for package management.
We highly recommend installing volta.sh to automatically manage NodeJS and Yarn versions. If you need to run Informix locally, Docker is a suitable option.
Install NodeJS and Yarn via volta.sh.
A protoc compiler is required to generate stubs from protobuf definitions. You can follow instructions from the protobuf GitHub repo to install it on your machine.
The protobuf definitions for this project are located on the 'payment-api' branch of the repository https://github.com/topcoder-platform/plat-interface-definition. Clone the repository and switch to the 'payment-api' branch to access these definitions.
To run a local copy of Informix with the relevant tables, execute the following command in Docker:
docker run -p 2021:2021 -it appiriodevops/informix:1b3d4ef
If you are running this on an Apple Silicon Mac, you need to include the --platform linux/amd64
flag:
docker run --platform linux/amd64 -p 2021:2021 -it appiriodevops/informix:1b3d4ef
This project uses a private NPM repository. You will need a connection key to download the @topcoder-framework/
scoped library. Reach out to a member of the platform team to get this key.
To run the service with the Informix access layer locally, you need to have the 'feat/sql-expressions' branch of the repo https://github.com/topcoder-platform/informix-access-layer running locally.
After installing the dependencies, create a .env
file using the sample.env
as an example.
Then, you can install the project dependencies, build the protobuf files, and start the development server with these commands:
yarn install
yarn build:proto
yarn dev
For testing the method calls, you will need a gRPC client. We recommend using Postman. Please refer to the Postman documentation on how to setup and use it for gRPC requests.
If you follow these instructions, you should be able to get the gRPC service running locally on your machine. For any issues or additional information, please contact the platform team.