{"id":16299222,"url":"https://github.com/iamgkstack/biller-app","last_synced_at":"2026-01-21T01:02:46.366Z","repository":{"id":37882212,"uuid":"259340816","full_name":"iamgkstack/biller-app","owner":"iamgkstack","description":"simple biller application","archived":false,"fork":false,"pushed_at":"2023-03-04T14:51:06.000Z","size":589,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T21:42:13.774Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iamgkstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-27T14:02:25.000Z","updated_at":"2020-07-07T16:24:48.000Z","dependencies_parsed_at":"2024-10-27T22:17:00.105Z","dependency_job_id":"80a3aeb9-d381-43e8-b582-424825f37edb","html_url":"https://github.com/iamgkstack/biller-app","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iamgkstack/biller-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamgkstack%2Fbiller-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamgkstack%2Fbiller-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamgkstack%2Fbiller-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamgkstack%2Fbiller-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamgkstack","download_url":"https://codeload.github.com/iamgkstack/biller-app/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamgkstack%2Fbiller-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28620572,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T23:49:58.628Z","status":"ssl_error","status_checked_at":"2026-01-20T23:47:29.996Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-10T20:47:15.474Z","updated_at":"2026-01-21T01:02:46.343Z","avatar_url":"https://github.com/iamgkstack.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# biller-app\r\nsimple biller application\r\n\r\n## Requirements\r\n\r\n* NODE: `\u003e= 10`\r\n* YARN: `1.17.3`\r\n* POSTGRES: `10.10`\r\n* DATABASE: `biller_db`, `biller_db_test`\r\n\r\n## Setup\r\n\r\n```bash\r\n# clone the project\r\ngit clone https://github.com/iamgkstack/biller-app.git \u0026\u0026 cd biller-app\r\n\r\n# install the dependencies\r\nyarn\r\n\r\n# start the project\r\nyarn serve\r\n\r\n# test\r\nyarn test\r\n```\r\n\r\n* This starts the server on the port 5200\r\n* database seeds are located in `/src/sql/seeds`. These need to be run in the database\r\n\r\n## APIs available for Local Host\r\n\r\nHEALTH check API\r\n\r\n```\r\ncurl --location --request GET 'https://biller-node-js.herokuapp.com/api/v1/healthz'\r\n```\r\n\r\nFetch bill corresponding to the user\r\n\r\n```curl\r\ncurl --location --request GET 'http://localhost:5200/api/v1/fetch/bill?mobile=9721867247' \\\r\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJpd3VmaDg4d2hyYjQzaGpici4wMzRmc2FkbGtmajUuNndlcHEiLCJqdGkiOiIzYTdlMzUyMC04YzBiLTExZWEtOTQxNi01OTg2ZjBkYWFjZmUiLCJpYXQiOjE1ODgzNzkwNDQsImV4cCI6MTU4ODM4MDg0NH0.VULrnpIRDIs4W3g8viAs13nIYya3ttjRqeOK3NuMBsw'\r\n```\r\n\r\nFetch bill receipt against the billerBillID\r\n\r\n```curl\r\ncurl --location --request PUT 'http://localhost:5200/api/v1/fetch/billReceipt' \\\r\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJpd3VmaDg4d2hyYjQzaGpici4wMzRmc2FkbGtmajUuNndlcHEiLCJqdGkiOiIzYTdlMzUyMC04YzBiLTExZWEtOTQxNi01OTg2ZjBkYWFjZmUiLCJpYXQiOjE1ODgzNzkwNDQsImV4cCI6MTU4ODM4MDg0NH0.VULrnpIRDIs4W3g8viAs13nIYya3ttjRqeOK3NuMBsw' \\\r\n--header 'Content-Type: application/json' \\\r\n--data-raw '{\r\n    \"billerBillID\"   : \"12123131322\",\r\n    \"platformBillID\" : \"SETU121341312121\",\r\n    \"paymentDetails\" : {\r\n        \"platformTransactionRefID\" : \"TXN12121219\",\r\n        \"uniquePaymentRefID\"       : \"XXXXAYYDDD999999\",\r\n        \"amountPaid\" : {\r\n            \"value\" : 99000\r\n        },\r\n        \"billAmount\" : {\r\n            \"value\" : 99000\r\n        }\r\n    }\r\n}'\r\n```\r\n\r\n\r\n## APIs availbale Hosted on server\r\n\r\nHEALTH check API\r\n```\r\ncurl --location --request GET 'https://biller-node-js.herokuapp.com/api/v1/healthz'\r\n```\r\n\r\n\r\nFetch bill corresponding to the user\r\n\r\n```\r\ncurl --location --request GET 'https://biller-node-js.herokuapp.com/api/v1/fetch/bill?mobile=9721867247' \\\r\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJpd3VmaDg4d2hyYjQzaGpici4wMzRmc2FkbGtmajUuNndlcHEiLCJqdGkiOiIzYTdlMzUyMC04YzBiLTExZWEtOTQxNi01OTg2ZjBkYWFjZmUiLCJpYXQiOjE1ODgzNzkwNDQsImV4cCI6MTU4ODM4MDg0NH0.VULrnpIRDIs4W3g8viAs13nIYya3ttjRqeOK3NuMBsw'\r\n```\r\n\r\n\r\nFetch bill receipt against the billerBillID\r\n\r\n```\r\ncurl --location --request PUT 'https://biller-node-js.herokuapp.com/api/v1/fetch/billReceipt' \\\r\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJpd3VmaDg4d2hyYjQzaGpici4wMzRmc2FkbGtmajUuNndlcHEiLCJqdGkiOiIzYTdlMzUyMC04YzBiLTExZWEtOTQxNi01OTg2ZjBkYWFjZmUiLCJpYXQiOjE1ODgzNzkwNDQsImV4cCI6MTU4ODM4MDg0NH0.VULrnpIRDIs4W3g8viAs13nIYya3ttjRqeOK3NuMBsw' \\\r\n--header 'Content-Type: application/json' \\\r\n--data-raw '{\r\n    \"billerBillID\"   : \"12123131322\",\r\n    \"platformBillID\" : \"SETU121341312121\",\r\n    \"paymentDetails\" : {\r\n        \"platformTransactionRefID\" : \"TXN12121219\",\r\n        \"uniquePaymentRefID\"       : \"XXXXAYYDDD999999\",\r\n        \"amountPaid\" : {\r\n            \"value\" : 99000\r\n        },\r\n        \"billAmount\" : {\r\n            \"value\" : 99000\r\n        }\r\n    }\r\n}'\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamgkstack%2Fbiller-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamgkstack%2Fbiller-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamgkstack%2Fbiller-app/lists"}