https://github.com/kuwaitdevs/knet-dotnet-core-integration

RAW Integration of Knet payment gateway in .NET core
https://github.com/kuwaitdevs/knet-dotnet-core-integration

asp-net-core csharp dotnet-core fss-ipay knet kuwait php

Last synced: about 1 month ago
JSON representation

RAW Integration of Knet payment gateway in .NET core

• Host: GitHub
• URL: https://github.com/kuwaitdevs/knet-dotnet-core-integration
• Owner: kuwaitdevs
• License: mit
• Created: 2021-05-07T14:18:20.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2021-05-08T07:04:32.000Z (about 5 years ago)
• Last Synced: 2025-02-12T07:55:30.607Z (over 1 year ago)
• Topics: asp-net-core, csharp, dotnet-core, fss-ipay, knet, kuwait, php
• Language: C#
• Homepage:
• Size: 19.5 KB
• Stars: 2
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Knet Dotnet Core Integration

.NET Core RAW API Integration of Knet payment gateway.  

This is an unofficial port of the official PHP example provided by Knet.

## Why use RAW integration instead of iPayPipe (DLL)?

- iPayPipe requires [IKVM](https://www.ikvm.net/#Introduction) to work in C# based code which is not ideal, especially that the IKVM project is not in active development.

- The IKVM version provided by Knet is not compatible with .NET Core.

- This approach reduces dependencies and produces a lighter application footprint.

- The published app is compatible with all platforms.

## Disclaimer

- This is NOT an official port, use it at your own risk. No warranty is provided.

- This is a proof of concept and should not be used in a production environment.

- Please review Knet official documentation first before implementing.

## Development Requirements

- OS: Mac, Windows or Linux

- Visual Studio Code / Visual Studio (for debugging)

- .NET Core 5 SDK (for development) and .NET Core Hosting bundle (for publishing) https://dotnet.microsoft.com/download/dotnet/5.0

## Building and Publishing

- Run `dotnet restore`

- Build with `dotnet build`

- Run locally with `dotnet run`

- Publish with `dotnet publish`

## Before You Start

To test properly, please follow these steps:

- Contact Knet to provide you with Sandbox API details.

- Plug in your KNET details inside the appsettings.json, you will need:

  - Knet Sandbox Tranportal Id

  - Knet Sandbox Tranportal Password

  - Knet Sandbox Payment Api Url (kpaytest)

  - Knet Sandbox Terminal Resource Key

- Test using the checkout form.

- Once everything is OK, contact Knet to provide you with the production API details. (payment flow verification might be required)

- Implement the payment flow in your real project with the necessary adjustments such as:

  - Knet production API endpoint (kpay instead of kpaytest)

  - Proper Response and Error webhooks

  - Production Tranportal details

  - Proper Track ID generation

  - Database Integration

  - Logging

  - Additional Security

## Pages of Interest

- Index.cshtml: Landing page

- init-payment.cshtml and init-payment.cshtml.cs: Checkout page that kicks off the payment process

- payment-response.cshtml and payment-response.cshtml.cs: The response page/webhook that is used by Knet. Knet performs a POST request against this page once the process is finished from their side. The result can be successful (CAPTURED) or failed (anything else).

- payment-error.cshtml: The error page that is used by Knet. Knet performs a GET request against this page if there are any errors related to the payment gateway or the payment process.

- knetUtil.cs: Utility Knet class that contains the bulk of the encryption/decryption logic.

- phpExample.php: A summary of the official Knet PHP example. Use this file to compare .NET Core outputs with PHP outputs.