Cardknox.API.Wrapper 4.5.2

API Wrapper for Cardknox Payment Processor written in C#

Refer to https://kb.cardknox.com/api for full API reference or https://github.com/TheScripters/Cardknox-API-Wrapper/wiki/ for library reference

Install-Package Cardknox.API.Wrapper -Version 4.5.2
dotnet add package Cardknox.API.Wrapper --version 4.5.2
<PackageReference Include="Cardknox.API.Wrapper" Version="4.5.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Cardknox.API.Wrapper --version 4.5.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Quick Start - Charge a Credit Card (Sale)

Note: You may either pass a CardNum with a CVV and an expiration date OR pass a Token OR pass the raw card data (as MagStripe). The API will not accept multiple.

The order of preference for the API wrapper:

  1. Card Number, Expiration Date, CVV (optional)
  2. Token
  3. Mag Stripe.
using CardknoxApi;
using CardknoxApi.Operations;

CCSale save = new CCSale
{
    CardNum = "4444333322221111",
    CVV = "123", // optional, requirement determined by software security settings
    Exp = "1222" // Expiration Date: MMyy
};
Cardknox c = new  Cardknox(new CardknoxRequest("CardknoxKey", "SoftwareName", "SoftwareVersion"));
CardknoxResponse resp = c.CCSale(sale);

if (resp.HasError)
    throw new Exception(resp.Error);

string transactionId = resp.RefNum; // Always returned regardless of outcome
StatusType status = resp.Status; // Approved, Declined, Error
ResultType result = resp.Result; // A, D, E
string cardNum = resp.MaskedCardNumber; // eg 4xxxxxxxxxxx1111
string token = resp.Token; // Token returned for use with future transaction.
CardType cardType = resp.CardType; // Visa, Discover, etc

Quick Start - Charge a Credit Card (Sale)

Note: You may either pass a CardNum with a CVV and an expiration date OR pass a Token OR pass the raw card data (as MagStripe). The API will not accept multiple.

The order of preference for the API wrapper:

  1. Card Number, Expiration Date, CVV (optional)
  2. Token
  3. Mag Stripe.
using CardknoxApi;
using CardknoxApi.Operations;

CCSale save = new CCSale
{
    CardNum = "4444333322221111",
    CVV = "123", // optional, requirement determined by software security settings
    Exp = "1222" // Expiration Date: MMyy
};
Cardknox c = new  Cardknox(new CardknoxRequest("CardknoxKey", "SoftwareName", "SoftwareVersion"));
CardknoxResponse resp = c.CCSale(sale);

if (resp.HasError)
    throw new Exception(resp.Error);

string transactionId = resp.RefNum; // Always returned regardless of outcome
StatusType status = resp.Status; // Approved, Declined, Error
ResultType result = resp.Result; // A, D, E
string cardNum = resp.MaskedCardNumber; // eg 4xxxxxxxxxxx1111
string token = resp.Token; // Token returned for use with future transaction.
CardType cardType = resp.CardType; // Visa, Discover, etc

Release Notes

Added xCurrency field

Version History

Version Downloads Last updated
4.5.2 114 1/30/2019
4.5.1 101 1/29/2019
4.5.0 105 11/7/2018
4.0.0 106 10/30/2018
3.1.1 102 10/29/2018
3.0.2-beta 122 10/23/2018
3.0.1-beta 94 10/22/2018
3.0.0 112 10/22/2018
2.0.0 144 10/3/2018
1.0.0 145 10/2/2018
0.1.3-beta 94 9/29/2018
0.1.2-beta 120 9/25/2018
0.1.1-beta 102 9/24/2018
0.1.0-beta 99 9/24/2018