https://github.com/roodfluweel/paynl-csharp-sdk
Pay.nl C# SDK
https://github.com/roodfluweel/paynl-csharp-sdk
credit-card hacktoberfest payment-gateway payment-integration payment-methods payment-module payment-processing sdk
Last synced: 3 months ago
JSON representation
Pay.nl C# SDK
- Host: GitHub
- URL: https://github.com/roodfluweel/paynl-csharp-sdk
- Owner: roodfluweel
- License: mit
- Fork: true (paynl/csharp-sdk)
- Created: 2017-12-26T10:46:39.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2025-10-27T09:55:26.000Z (6 months ago)
- Last Synced: 2025-10-27T11:38:06.411Z (6 months ago)
- Topics: credit-card, hacktoberfest, payment-gateway, payment-integration, payment-methods, payment-module, payment-processing, sdk
- Language: C#
- Homepage:
- Size: 3.6 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.nuget.org/packages/RoodFluweel.PAYNLSDK/)
[](https://github.com/roodfluweel/csharp-sdk/actions/workflows/dotnet.yml)
# Pay.nl C# SDK
With this SDK you will be able to start transactions and retrieve transactions with
their status for the Pay.nl payment service provider.
## Installation
You can use this package as a nuget package:
From nuget:
```shell
Install-Package RoodFluweel.PAYNLSDK
```
## Configuration
Setting the configuration:
```c#
var payNlConfig = new PAYNLSDK.API.PayNlConfiguration("SL-1234-1234", "e4test6b70code9adreplacef0fee5e0ab");
var client = new PAYNLSDK.Net.Client(payNlConfig);
```
## Usage of the GetService
Getting a list of available payment methods, use the Getservice.
```c#
var response = PAYNLSDK.Transaction.GetService(paymentMethodId);
//paymentMethodId: is optional
//The ID of the payment method. Only the payment options linked to the provided payment method ID will be returned if an ID is provided.
//If omitted, all available payment options are returned. Use the following IDs to filter the options:
//1. SMS.
//2. Pay fixed price.
//3. Pay per call.
//4. Pay per transaction
//5. Pay per minute.
```
## Starting a transaction
```c#
PAYNLSDK.API.Transaction.Start.Request request = PAYNLSDK.Transaction.CreateTransactionRequest("127.0.0.1", "http://example.org/visitor-return-after-payment");
request.Amount = 7184; // Amount in cents
request.PaymentOptionId = 10; // Payment profile/option
// request.PaymentOptionSubId = 5081; // Set bank id for iDEAL (example)
// Optional values
options.store("paymentMethod", 10);
options.store("description", "demo payment");
options.store("language","EN");
// Transaction data
request.Transaction = new PAYNLSDK.Objects.TransactionData();
request.Transaction.Currency = "EUR";
request.Transaction.CostsVat = null;
request.Transaction.OrderExchangeUrl = "https://example.org/exchange.php";
request.Transaction.Description = "TEST PAYMENT";
request.Transaction.ExpireDate = DateTime.Now.AddDays(14);
// Optional Stats data
request.StatsData = new PAYNLSDK.Objects.StatsDetails();
request.StatsData.Info = "your information";
request.StatsData.Tool = "C#.NET";
request.StatsData.Extra1 = "X";
request.StatsData.Extra2 = "Y";
request.StatsData.Extra3 = "Z";
// Initialize Salesdata
request.SalesData = new PAYNLSDK.Objects.SalesData();
request.SalesData.InvoiceDate = DateTime.Now;
request.SalesData.DeliveryDate = DateTime.Now;
request.SalesData.OrderData = new System.Collections.Generic.List();
// Add products
request.SalesData.OrderData.Add(new PAYNLSDK.Objects.OrderData("SKU-8489", "Testproduct 1", 2995, "H", 1));
request.SalesData.OrderData.Add(new PAYNLSDK.Objects.OrderData("SKU-8421", "Testproduct 2", 995, "H", 1));
request.SalesData.OrderData.Add(new PAYNLSDK.Objects.OrderData("SKU-2359", "Testproduct 3", 2499, "H", 1));
// Add shipping
request.SalesData.OrderData.Add(new PAYNLSDK.Objects.OrderData("SHIPPINGCOST", "Shipping of products", 695, "H", 1, "SHIPPING"));
// enduser
request.Enduser = new PAYNLSDK.Objects.EndUser();
request.Enduser.Language = "NL";
request.Enduser.Initials = "J.";
request.Enduser.Lastname = "Buyer";
request.Enduser.Gender = PAYNLSDK.Enums.Gender.Male;
request.Enduser.BirthDate = new DateTime(1991, 1, 23, 0, 0, 0, DateTimeKind.Local);
request.Enduser.PhoneNumber = "0612345678";
request.Enduser.EmailAddress = "email@domain.com";
request.Enduser.BankAccount = "";
request.Enduser.IBAN = "NL08INGB0000000555";
request.Enduser.BIC = "";
// enduser address
request.Enduser.Address = new PAYNLSDK.Objects.Address();
request.Enduser.Address.StreetName = "Streetname";
request.Enduser.Address.StreetNumber = "8";
request.Enduser.Address.ZipCode = "1234AB";
request.Enduser.Address.City = "City";
request.Enduser.Address.CountryCode = "NL";
// invoice address
request.Enduser.InvoiceAddress = new PAYNLSDK.Objects.Address();
request.Enduser.InvoiceAddress.Initials = "J.";
request.Enduser.InvoiceAddress.LastName = "Jansen";
request.Enduser.InvoiceAddress.Gender = PAYLSDK.Enums.Gender.Male;
request.Enduser.InvoiceAddress.StreetName = "InvoiceStreetname";
request.Enduser.InvoiceAddress.StreetNumber = "10";
request.Enduser.InvoiceAddress.ZipCode = "1234BC";
request.Enduser.InvoiceAddress.City = "City";
request.Enduser.InvoiceAddress.CountryCode = "NL";
// Do the call
var transaction = new PAYNLSDK.Transaction(client).Start(request);
// do whatever you need to do
var transactionId = transaction.Transaction.TransactionId;
var redirectToUrl = transaction.Transaction.PaymentURL;
```
To determine if a transaction has been paid, you can use:
```c#
var transactionInfo = new PAYNLSDK.Transaction(client).Info(transactionId);
var paid = transactionInfo.PaymentDetails.State == PaymentStatus.PAID;
// or use the extentionmethods by adding "using PAYNLSDK.API.Transaction.Info;" at the top of your file
if (transactionInfo.IsPaid() || transactionInfo.IsPending())
{
// redirect user to thank you page
}
else
{
// it has not been paid yet, so redirect user back to checkout
}
```
### Exchange scripts
When implementing the exchange script (where you should process the order in your backend):
```c#
var info = PAYNLSDK.Transaction.Info(response.transactionId);
PAYNLSDK.Enums.PaymentStatus result = info.PaymentDetails.State;
if (PAYNLSDK.Transaction.IsPaid(result))
{
// process the payment
}
else
{
if(PAYNLSDK.Transaction.IsCancelled(result)){
// payment canceled, restock items
}
}
response.Write("TRUE| ");
// Optionally you can send a message after TRUE|, you can view these messages in the logs.
// https://admin.pay.nl/logs/payment_state
response.Write("Paid");
```
## Alliance
The following Alliance methods are available:
- getMerchant
- addMerchant
- addInvoice
## Statistics
The following statistics methods are available:
- statistics/GetManagement
## Contributing
Feel free to do pull requests and create issues when you please.
## License
This project is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).