https://github.com/lyra/aspnet-payment-form-examples

Sample code for integrating Lyra payment platform in ASP.NET environment using HTML form.
https://github.com/lyra/aspnet-payment-form-examples

Last synced: 4 days ago
JSON representation

Sample code for integrating Lyra payment platform in ASP.NET environment using HTML form.

• Host: GitHub
• URL: https://github.com/lyra/aspnet-payment-form-examples
• Owner: lyra
• License: gpl-3.0
• Created: 2018-06-19T11:43:23.000Z (over 6 years ago)
• Default Branch: develop
• Last Pushed: 2022-10-21T13:54:59.000Z (about 2 years ago)
• Last Synced: 2023-04-10T20:01:03.929Z (over 1 year ago)
• Language: C#
• Size: 77.1 KB
• Stars: 1
• Watchers: 5
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: COPYING.md

Awesome Lists containing this project

README

        
# Lyra ASP.NET payment form example

## Introduction

The code presented here is an example of the implementation of the Lyra payment gateway form API in ASP.NET technology. It aims to ease its use and learning.

## Contents

* Checkout.aspx (and its .cs file): an HTML form to enter main order data.

* CheckoutConfirm.aspx (and its .cs file): an order preview page that will send data to the payment gateway.

* PaymentResult.aspx (and its .cs file): the page to be called by IPN callback and where the buyer will return at the end of payment.

* PaymentUtils.cs: a core file that contains the Lyra payment API logic (generate IDs, process signature, build redirect form).

* Web.config: application configuration file to set necessary parameters (at least, gateway credentials).

* Some other resources for styling pages and managing translations.

## Prequisites:

The following component should be installed:

* .NET Core 3.1 or later versions.

## First use

* Copy the content of this project to a directory at the root of your store on the web server.

* Set your Lyra API credentials in the Web.config file. You can also configure some other fields.

* Set the IPN URL to `http://www.your-site.com/PaymentResult.aspx` into your Lyra Back Office > Settings > Notification rules.

* Access `www.your-site.com/Checkout.aspx` from the browser.

* N.B:

   If you are getting the following error: `Microsoft.CodeDom.Providers.DotNetCompilerPlatform.CSharpCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=1.0.8.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35` could not be located, 

   then the IIS server you're deploying on doesn't support the Roselyn reference. You should either upgrade the server or comment the "system.codedom" section in the `Web.config` file, then restart the IIS server.

* Follow the Lyra sample indications to perform the payment.

## Next steps

* You can customize checkout form (in Checkout.aspx) or plug your own form with data to be sent to the gateway (in CheckoutConfirm.aspx.cs).

* You should implement your own order management logic (update order status, manage stock, send confirmation e-mail, ...) in PaymentResult.aspx.cs.

* You should customize payment result messages and/or make redirection to your own result pages in PaymentResult.aspx.cs.

* Finally, you can change the ctx_mode parameter from `TEST` to `PRODUCTION` to switch to the live payment mode, with *all* the caution this decision expects.

## Note

* Please refer to the gateway documentation titled "Implementation guide - Interface with the payment gateway" to customize this code example.

## License

Each source file included in this distribution is licensed under GNU GENERAL PUBLIC LICENSE (GPL 3.0). Please see LICENSE.txt for the full text of the GPL 3.0 license. It is also available through the world-wide-web at this URL: http://www.gnu.org/licenses/.