FonsecaFramework.Visa 2026.5.21.1

FonsecaFramework.Visa

VISA REST API integration library for .NET.

Overview

FonsecaFramework.Visa is a .NET Standard 2.1 library that provides clients for the Visa Developer Platform REST APIs. It includes support for Visa Direct (pull and push funds), foreign exchange rate lookups, and an authenticated base client that handles X-Pay Token (HMAC-SHA256) generation automatically.

Installation

dotnet add package FonsecaFramework.Visa

Features

Examples

Pull Funds (Visa Direct)

using FonsecaFramework.Visa;

var visaDirect = new VisaDirectService(
    baseUri: "https://sandbox.api.visa.com",
    apiKey: "<your-api-key>",
    apiSecret: "<your-api-secret>");

var payee = new CardAcceptor
{
    Name = "Acme Merchant",
    TerminalId = "TID-001",
    IdCode = "CA-IDCode-77765",
    State = "CA",
    County = "San Mateo",
    Country = "840",
    ZipCode = "94404"
};

string result = await visaDirect.PullFundsAsync(
    senderCardNumber: "4111111111111111",
    amount: "100.00",
    currencyCode: "USD",
    recipientPrimaryAccountNumber: "4957030420210496",
    payee: payee,
    cardType: CardType.VisaCredit);

Console.WriteLine(result);

Push Funds (Visa Direct)

using FonsecaFramework.Visa;

var visaDirect = new VisaDirectService(
    baseUri: "https://sandbox.api.visa.com",
    apiKey: "<your-api-key>",
    apiSecret: "<your-api-secret>");

string result = await visaDirect.PushFundsAsync(
    recipientPrimaryAccountNumber: "4957030420210496",
    amount: "50.00",
    _: "USD");

Console.WriteLine(result);

Get Foreign Exchange Rate

using FonsecaFramework.Visa;

var fxClient = new ForeignExchangeRateClient(
    apiKey: "<your-api-key>",
    sharedSecret: "<your-shared-secret>");

ExchangeRateResult? rate = await fxClient.GetExchangeRateAsync(
    fromCurrency: "USD",
    toCurrency: "EUR");

if (rate != null)
{
    Console.WriteLine($"Rate: {rate.ConversionRate}");
    Console.WriteLine($"{rate.BaseCurrency} -> {rate.DestinationCurrency}");
}

Requirements

• .NET Standard 2.1 compatible runtime
• Visa Developer Platform credentials

License

Copyright 2025 Steven Fonseca / VLR Creations

Licensed under the Apache License, Version 2.0. You may use this library free of charge, provided you include the required attribution notices. See the LICENSE file for full terms.