VNS.NetsEasy 3.0.2

VNS NetsEasy

Simple integration to NetsEasy

Installation

Use the package manager nuget to install.

dotnet add package VNS.NetsEasy

Init payment

// Test variable
var _isTest = true;

// Keys - Find your keys in NetsEasy portal
var _secretKey = "test-secret-key-XXXXXXXX";
var _checkoutKey = "test-checkout-key-XXXXXXXX";
if(!_isTest){ // If not test, use live keys
    _secretKey = "live-secret-key-XXXXXXXX";
    _checkoutKey = "live-checkout-key-XXXXXXXX";
}

// Init and build order
var easy = new NetsEasy(_secretKey, _isTest){
	TermsUrl = "https://domain.com/Terms",
	ReturnUrl = "https://domain.com/ReturnUrl",
	ShowMerchantName = true, // Display merchant name on payform
	ShowSummary = true, // Display cart summery on payform
	ChargeOrder = false, // Should the order be charged after complete
	IsSubscription = false, // If it's a subscription or single payment
	PricesIncludeTax = true, // Does prices include tax (Default 25% tax)
	IntegrationType = IntegrationType.EmbeddedCheckout, // Integration type: EmbeddedCheckout or hostedPaymentPage
    Customer = new VNS.NetsEasy.Customer() { // Customer object
    	Id = "0001",
    	CompanyName = "My Company",
    	FirstName = "John",
    	LastName = "Doe",
        AddressLine1 = "My address",
    	ZipCode = "0000",
    	City = "My Cirt",
    	Phone = "00000000",
    	Email = "email@domain.com"
    }
};
	
// Add items to order
for(int i = 1; i <= 1; i++){
	easy.Items.Add(new VNS.NetsEasy.Item() {
	    Id = $"Item {i}",
	    Name = $"Vare {i}",
	    Amount = 1,
	    Unit = "stk",
	    Price = decimal.Parse("100")
	});
}
	
// Add webhooks - See NetsEasy documentation for more information
easy.WebHooks.Add(new VNS.NetsEasy.WebHook(){
	Auth = "MyAuthKey",
    Name = "payment.checkout.completed", // See Webhook section or NetsEasy documentation for more information
    Url = "https://domain.com/WebHook",
    Headers = new { // Add as many as needed
    	name = "John Doe",
    	email = "email@domain.com",
	}
});
	
// Init payment
var result = easy.InitPayment(out string payload);

// Debug stuff
var statusCode = easy.StatusCode; // Get status code from NetsEasy
var statusDescription = easy.StatusDescription; // Get status description from NetsEasy
var paymentId = easy.PaymentId; // Get the paymentId
var payload = payload; // Will return the raw json that is sent to NetsEasy
var result = result; // Will return the raw json that contains paymentid and/or hosted url


// Check integration type
if(_integrationType == _integrationType.EmbeddedCheckout){
    var htmlForm = easy.GetEmbedHtml(_checkoutKey); // Will return the html for the payment form to embed
} else { // Hosted
    var hostedUrl = easy.GetHostUrl(); // Will return the url to the payment form
}

Get payment

// Test variable
var _isTest = true;

// Keys - Find your keys in NetsEasy portal
var _secretKey = "test-secret-key-XXXXXXXX";
if(!_isTest){ // If not test, use live key
    _secretKey = "live-secret-key-XXXXXXXX";
}

// Init
var easy = new NetsEasy(_secretKey, _isTest);

// Get payment
string paymentId = "";
var payment = easy.GetPayment(paymentId); // Will return raw json

Charge payment

// Test variable
var _isTest = true;

// Keys - Find your keys in NetsEasy portal
var _secretKey = "test-secret-key-XXXXXXXX";
if(!_isTest){ // If not test, use live key
    _secretKey = "live-secret-key-XXXXXXXX";
}

// Init
var easy = new NetsEasy(_secretKey, _isTest);

// Charge payment
string paymentId = "";
var payment = easy.ChargePayment(paymentId) // Will return raw json

Cancel payment

// Test variable
var _isTest = true;

// Keys - Find your keys in NetsEasy portal
var _secretKey = "test-secret-key-XXXXXXXX";
if(!_isTest){ // If not test, use live key
    _secretKey = "live-secret-key-XXXXXXXX";
}

// Init
var easy = new NetsEasy(_secretKey, _isTest);

// Cancel payment
string paymentId = "";
var payment = easy.CancelPayment(paymentId) // Will return raw json

Get subscription

// Test variable
var _isTest = true;

// Keys - Find your keys in NetsEasy portal
var _secretKey = "test-secret-key-XXXXXXXX";
if(!_isTest){ // If not test, use live key
    _secretKey = "live-secret-key-XXXXXXXX";
}

// Init
var easy = new NetsEasy(_secretKey, _isTest);

// Get subscription
string subscriptionId = "";
var subscription = easy.GetSubscription(subscriptionId); // Will return raw json

Charge subscription

// Test variable
var _isTest = true;

// Keys - Find your keys in NetsEasy portal
var _secretKey = "test-secret-key-XXXXXXXX";
if(!_isTest){ // If not test, use live key
    _secretKey = "live-secret-key-XXXXXXXX";
}

// Init
var easy = new NetsEasy(_secretKey, _isTest);

// Add items to order
for(int i = 1; i <= 1; i++){
	easy.Items.Add(new VNS.NetsEasy.Item() {
	    Id = $"Item {i}",
	    Name = $"Vare {i}",
	    Amount = 1,
	    Unit = "stk",
	    Price = decimal.Parse("100")
	});
}
	
// Add webhooks - See NetsEasy documentation for more information
easy.WebHooks.Add(new VNS.NetsEasy.WebHook(){
	Auth = "MyAuthKey",
    Name = "payment.checkout.completed", // See Webhook section or NetsEasy documentation for more information
    Url = "https://domain.com/WebHook",
    Headers = new { // Add as many as needed
    	name = "John Doe",
    	email = "email@domain.com",
	}
});

// Charge subscription
string subscriptionId = "";
var subscription = easy.ChargeSubscription(subscriptionId); // Will return raw json

Webhook

/* Subscription Hook Names
	payment.charge.created
	payment.charge.created.v2
	payment.charge.failed
*/

/* Payment Hook Names
	payment.created
	payment.reservation.created
	payment.reservation.created.v2
	payment.checkout.completed
	payment.charge.created
	payment.charge.created.v2
	payment.charge.failed
	payment.refund.initiated
	payment.refund.initiated.v2
	payment.refund.failed
	payment.refund.completed
	payment.cancel.created
	payment.cancel.failed
*/

var auth = WebHook.GetAuth(); // Will return the string value from the auth tag set when building the webhook
var name = WebHook.GetName(); // Will return the name of the webhook
var headers = WebHook.GetHeaders(); // Will return IHeaderDictionary with all headers
var data = WebHook.GetData(); // Will return the posted body

License

MIT