FTNI.Payments.DirectForm.Net 1.0.0

FTNI.Payments.DirectForm.Net

A .NET 8 library for integrating with the FTNI (Financial Transmission Network, Inc.) DirectForm payment gateway. This library simplifies the process of handling payment responses and building redirect requests for secure payment processing.

Features

• Payment Response Processing: Parse and validate payment responses from the FTNI DirectForm gateway
• Multiple Payment Types: Support for credit card, ACH, and saved payment methods
• Response Status Handling: Built-in handling for Approved, Declined, Saved, Error, and Fatal response types
• Cryptographic Validation: Secure validation of payment responses using BouncyCastle
• Redirect Helper: Utilities for building secure redirect URLs with optional refresh warnings
• ASP.NET Core Integration: Works seamlessly with ASP.NET Core HttpContext

Installation

Install the package via NuGet Package Manager:

dotnet add package FTNI.Payments.DirectForm.Net

Or via the Package Manager Console:

Install-Package FTNI.Payments.DirectForm.Net

Quick Start

Processing a Payment Response

using FTNI.Payments.DirectForm.Net;
using Microsoft.AspNetCore.Mvc;

public class PaymentController : Controller
{
	[HttpPost]
	public IActionResult ProcessPayment()
	{
		var paymentResponse = new PaymentResponse(HttpContext);

		if (paymentResponse.IsFatal())
		{
			var fatal = paymentResponse.GetFatal();
			// Handle fatal error
			return View("Error", fatal);
		}

		if (paymentResponse.IsApproved())
		{
			var approved = paymentResponse.GetApproved();
			// Process approved payment
			return View("Success", approved);
		}

		if (paymentResponse.IsDeclined())
		{
			var declined = paymentResponse.GetDeclined();
			// Handle declined payment
			return View("Declined", declined);
		}

		if (paymentResponse.IsSaved())
		{
			var saved = paymentResponse.GetSaved();
			// Handle saved payment method
			return View("PaymentSaved", saved);
		}

		// Handle other cases
		return View("Error");
	}
}

Building Redirect Content

using FTNI.Payments.DirectForm.Net.Helpers;

string redirectUrl = "https://payment-gateway.example.com/process";
string warningText = "Please do not refresh this page.";

string htmlContent = RedirectorHelper.RedirectContent(redirectUrl, warningText);
return Content(htmlContent, "text/html");

Response Types

The library supports the following response types:

• Approved: Payment was successfully processed
• Declined: Payment was declined by the processor
• Saved: Payment method was saved for future use
• Error: An error occurred during processing
• Fatal: A critical error occurred

Requirements

• .NET 8.0 or higher
• ASP.NET Core (for HttpContext integration)

Dependencies

• BouncyCastle.Cryptography (2.6.2+): For cryptographic validation
• Microsoft.AspNetCore.Http.Abstractions (2.3.11+): For HTTP context integration

License

Proprietary - FTNI Clients Only

This library is licensed for use by authorized FTNI clients only. See the LICENSE.txt file for complete terms and conditions.

Usage requires:

• An active FTNI client agreement
• FTNI DirectForm payment gateway access
• Acceptance of the commercial license terms

For licensing inquiries, please contact FTNI Client Support.

Support

For support and documentation, please contact Financial Transmission Network, Inc. (FTNI) or visit their developer portal.

Security

This library handles sensitive payment information. Always ensure:

• Use HTTPS for all payment-related communications
• Validate all payment responses using the included cryptographic helpers
• Follow PCI DSS compliance guidelines
• Never log or store sensitive payment data

Contributing

This is a proprietary library for FTNI DirectForm integration. For feature requests or bug reports, please contact FTNI support.