Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dianper/payment-api
A basic payment API in .NETCore
https://github.com/dianper/payment-api
csharp docker dockerfile fluent fluentvalidation gitactions-workflow jwt jwt-authentication metrics microservice microservices-architecture netcore netcore31 payment-api prometheus quality sonarqube swagger unit-testing
Last synced: about 1 month ago
JSON representation
A basic payment API in .NETCore
- Host: GitHub
- URL: https://github.com/dianper/payment-api
- Owner: dianper
- Created: 2020-11-02T09:41:09.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-02-05T13:01:48.000Z (about 4 years ago)
- Last Synced: 2024-11-08T02:03:28.998Z (3 months ago)
- Topics: csharp, docker, dockerfile, fluent, fluentvalidation, gitactions-workflow, jwt, jwt-authentication, metrics, microservice, microservices-architecture, netcore, netcore31, payment-api, prometheus, quality, sonarqube, swagger, unit-testing
- Language: C#
- Homepage:
- Size: 85 KB
- Stars: 0
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/dianper/payment-gateway/actions?query=workflow%3A%22.NET+Core%22)
[](https://sonarcloud.io/dashboard?id=dianper_payment-gateway)
# Payment API
Payment API in .NETCore
## Requirements
- Docker
## Run Fake Acquiring Bank Client
```
# cd /src/AcquiringBank
docker build -t acquiringbankapi .
docker run -d -p 44385:80 --name fakebank acquiringbankapi
```
## Run Payment API
```
# cd /src/PaymentGateway
docker build -t paymentgatewayapi .
docker run -d -p 44386:80 --name paymentgateway paymentgatewayapi
```
## Mock Data
```
# Valid MerchantIds
- 63d33faf-7781-48c9-a2f5-a035d1799735
- e5f18ed2-3a06-40b1-85db-3eec9624cc0f
# Card Numbers & Transaction Status
4485008383107041 - Failed
5468797069745763 - Rejected
4913317908108661 - Accepted (if amount > 150 or transaction will be rejected)
# Credit Card Number Generator
https://www.freeformatter.com/credit-card-number-generator-validator.html
```
## Features
- Model validation using FluentValidation
- Data Storage using EF Core Database In Memory
- Authentication using JWT
- API Docs using Swagger
- CI using Github Actions
- Code Quality using Sonarqube
- Fake Acquiring Bank using HttpClient
- Dockerfile to Acquiring Bank and Payment Gateway API
- UnitTests
- Metrics using Prometheus
## Swagger
- http://localhost:44386/swagger
## Metrics
- http://localhost:44386/metrics
## Endpoints
- POST: Authentication (http://localhost:44386/api/v1/auth)
Body
```json
{
"username": "paymentgateway",
"password": "2020"
}
```
Response
```json
{
"result": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MDQ4NzUwODUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3Q6NTA5NTYiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0OjUwOTU2In0.EQn3ztnNg_DaV5T8-hKAL3vj6WvW6gQeyGVtu9zC9-k",
"expiration": "2020-11-08T22:38:05.7333286+00:00"
},
"success": true,
"errors": {}
}
```
- POST: Payment Process (http://localhost:44386/api/v1/payment)
Body
```json
{
"merchantId": "63d33faf-7781-48c9-a2f5-a035d1799735",
"cardNumber": "4913317908108661",
"expiryMonth": 12,
"expiryYear": 2020,
"securityCode": 123,
"amount": 1500,
"currency": "USD"
}
```
Response
```json
{
"result": {
"paymentId": "c1870526-0a9f-4256-9594-8213646af506",
"transactionId": "214e22ee-a33a-4ca4-8b32-6a12b83bdbf4",
"transactionStatus": "Accepted"
},
"success": true,
"errors": {}
}
```
- GET: Payment Details (http://localhost:44386/api/v1/payment)
Body
```json
{
"paymentId": "c1870526-0a9f-4256-9594-8213646af506"
}
```
Response
```json
{
"result": {
"paymentId": "c1870526-0a9f-4256-9594-8213646af506",
"paymentDate": "2020-11-08T20:45:32.8736427+00:00",
"amount": 1500,
"cardNumberMasked": "************8661",
"transactionId": "214e22ee-a33a-4ca4-8b32-6a12b83bdbf4",
"transactionStatus": "Accepted"
},
"success": true,
"errors": {}
}
```