ktpay-dotnet

Bu proje, Kuveyt Türk Katılım Bankası Sanal POS servisleri için geliştirilen entegrasyon alt yapı kodlarını içermektedir. Proje içerisinde yer alan kodlar, Kuveyt Türk Katılım Bankası tarafından sunulan çevrimiçi ödeme hizmetlerini entegre etmek ve sanal pos işlemlerini gerçekleştirmek amacıyla kullanılabilir. Aksi kullanımlar banka tarafından tespit edilip cezai yaptırımlar uygulanmaktadır.

Entegrasyon sırasında karşılaşılan hataların çözümü için Kuveyt Türk Sanal POS Destek ekibi ile iletişime geçebilirsiniz.

English

Gereksinimler

.NET Standart 2.0
.NET Core 8 (Tests ve Web projeleri için)

.NET Uyumluluğu

.NET uygulaması	Sürüm desteği
.NET ve .NET Core	2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0
.NET Framework	4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Mono	5.4, 6.4
Xamarin.iOS	10.14, 12.16
Xamarin.Mac	3.8, 5.16
Xamarin.Android	8.0, 10.0
Evrensel Windows Platformu	10.0.16299, TBD
Unity	2018.1

Kurulum

# Proje dosyalarını yerel bilgisayarınıza klonlayın.
git clone https://github.com/kuveytturk/ktpay-dotnet.git

# Entegrasyon bilgilerinizi düzenleyin.
nano .\KTPay.Web\appsettings.json

# Proje dizinine gidin ve projeyi ayağa kaldırın.
cd .\ktpay-dotnet\KTPay.Web\
dotnet watch run

Örnek Kodlar

Satış

Request

var request = new PaymentRequest() {
    PaymentType = 1,
    Language = Language.TR.GetValue(),
    MerchantOrderId = "KT TEST",
    SuccessUrl = "http://localhost:3000/KTPay/Success",
    FailUrl = "http://localhost:3000/KTPay/Fail",
    MerchantId = Convert.ToInt32(envConfig.MerchantId),
    CustomerId = Convert.ToInt32(envConfig.CustomerId),
    Username = envConfig.Username,
    Amount = "100",
    Currency = Currency.TRY.ToString(),
    InstallmentCount = 1,
    Customer = new Customer() {
        FullName = "JOHN DOE",
        IdentityNumber = "12345678901",
        Email = "noreply@kuveytturk.com.tr",
        PhoneNumber = new Phone() {
            Cc = "90",
            Subscriber = "5001112233"
        },
        IpAddress = "127.0.0.1"
    },
    Card = new Card() {
        CardHolderName = cardConfig.CardHolderName,
        CardNumber = cardConfig.CardNumber,
        ExpireMonth = cardConfig.ExpireMonth,
        ExpireYear = cardConfig.ExpireYear,
        SecurityCode = cardConfig.SecurityCode 
    },
    Cart = new List<CartItem>() {
        new CartItem() {
            CartItemName = "Product PHYSICAL",
            CartItemUrl = "https://www.kuveytturk.com.tr",
            CartItemType = (int)CartItemType.PHYSICAL,
            Quantity = 1.5,
            Price = "10",
            TotalAmount = "15"
        },
        new CartItem() {
            CartItemName = "Product VIRTUAL",
            CartItemUrl = "https://www.kuveytturk.com.tr",
            CartItemType = (int)CartItemType.VIRTUAL,
            Quantity = 1,
            Price = "85",
            TotalAmount = "85"
        }
    },
    InvoiceAddress = new InvoiceAddress() {
        Company = "XXX LTD.STI.",
        TaxNumber = "111111111",
        TaxOffice = "XXXXXXXXX",
        Address = "ADDRESS",
        City = "IZMIT",
        State = State.Kocaeli.ToString(),
        Country = Country.Turkiye.ToString(),
        ZipCode = "123456"
    },
    ShippingAddress = new ShippingAddress() {
        FullName = "JOHN DOE",
        Address = "ADDRESS",
        City = "IZMIT",
        State = State.Kocaeli.ToString(),
        Country = Country.Turkiye.ToString(),
        ZipCode = "123456"
    }
};
request.SetHashData(envConfig.Password);

Response

{
  "result": {
    "orderId": 203418364,
    "md": "V41ORA43CP2rFY+rO+zXe39dCnsSAAOEkLlBOheeO+43M45+U1oWc6p9f0EBMbeu",
    "merchantOrderId": "KTPay-DotNet-2771838446527563693"
  },
  "success": true,
  "responseCode": "00",
  "responseMessage": "Kart doğrulandı.",
  "businessKey": 202406079999000000041584825,
  "transactionTime": 1717778734
}

Taksitli Satış

Request

var request = new PaymentRequest() {
    PaymentType = 1,
    Language = Language.TR.GetValue(),
    MerchantOrderId = "KT TEST",
    SuccessUrl = "http://localhost:3000/KTPay/Success",
    FailUrl = "http://localhost:3000/KTPay/Fail",
    MerchantId = Convert.ToInt32(envConfig.MerchantId),
    CustomerId = Convert.ToInt32(envConfig.CustomerId),
    Username = envConfig.Username,
    Amount = "100",
    Currency = Currency.TRY.ToString(),
    InstallmentCount = 2,
    Customer = new Customer() {
        FullName = "JOHN DOE",
        IdentityNumber = "12345678901",
        Email = "noreply@kuveytturk.com.tr",
        PhoneNumber = new Phone() {
            Cc = "90",
            Subscriber = "5001112233"
        },
        IpAddress = "127.0.0.1"
    },
    Card = new Card() {
        CardHolderName = cardConfig.CardHolderName,
        CardNumber = cardConfig.CardNumber,
        ExpireMonth = cardConfig.ExpireMonth,
        ExpireYear = cardConfig.ExpireYear,
        SecurityCode = cardConfig.SecurityCode 
    },
    Cart = new List<CartItem>() {
        new CartItem() {
            CartItemName = "Product PHYSICAL",
            CartItemUrl = "https://www.kuveytturk.com.tr",
            CartItemType = (int)CartItemType.PHYSICAL,
            Quantity = 1.5,
            Price = "10",
            TotalAmount = "15"
        },
        new CartItem() {
            CartItemName = "Product VIRTUAL",
            CartItemUrl = "https://www.kuveytturk.com.tr",
            CartItemType = (int)CartItemType.VIRTUAL,
            Quantity = 1,
            Price = "85",
            TotalAmount = "85"
        }
    },
    InvoiceAddress = new InvoiceAddress() {
        Company = "XXX LTD.STI.",
        TaxNumber = "111111111",
        TaxOffice = "XXXXXXXXX",
        Address = "ADDRESS",
        City = "IZMIT",
        State = State.Kocaeli.ToString(),
        Country = Country.Turkiye.ToString(),
        ZipCode = "123456"
    },
    ShippingAddress = new ShippingAddress() {
        FullName = "JOHN DOE",
        Address = "ADDRESS",
        City = "IZMIT",
        State = State.Kocaeli.ToString(),
        Country = Country.Turkiye.ToString(),
        ZipCode = "123456"
    }
};
request.SetHashData(envConfig.Password);

Response

{
  "result": {
    "orderId": 203418364,
    "md": "V41ORA43CP2rFY+rO+zXe39dCnsSAAOEkLlBOheeO+43M45+U1oWc6p9f0EBMbeu",
    "merchantOrderId": "KTPay-DotNet-2771838446527563693"
  },
  "success": true,
  "responseCode": "00",
  "responseMessage": "Kart doğrulandı.",
  "businessKey": 202406079999000000041584825,
  "transactionTime": 1717778734
}

Satış ve Taksitli Satış - Provizyon

Request

var request = new ProvisionRequest() {
    Language = Language.TR.GetValue(),
    MerchantId = Convert.ToInt32(envConfig.MerchantId),
    CustomerId = Convert.ToInt32(envConfig.CustomerId),
    Username = envConfig.Username,
    OrderId = 203418364,
    MerchantOrderId = "KTPay-DotNet-2771838446527563693",
    Amount = "100",
    Md = "V41ORA43CP2rFY+rO+zXe39dCnsSAAOEkLlBOheeO+43M45+U1oWc6p9f0EBMbeu"
};
request.SetHashData(envConfig.Password);

Response

{
  "result": {
    "orderId": 203418364,
    "merchantOrderId": "KTPay-DotNet-2771838446527563693"
  },
  "success": true,
  "responseCode": "00",
  "responseMessage": "OTORİZASYON VERİLDİ",
  "businessKey": 202406079999000000041601797,
  "transactionTime": 1717778857
}

İptal, İade ve Kısmi İade

Request

var request = new SaleReversalRequest() {
    Language = Language.TR.GetValue(),
    SaleReversalType = SaleReversalType.CANCEL, //SaleReversalType.DRAWBACK, SaleReversalType.PARTIAL_DRAWBACK
    MerchantId = Convert.ToInt32(envConfig.MerchantId),
    CustomerId = Convert.ToInt32(envConfig.CustomerId),
    Username = envConfig.Username,
    OrderId = 203418364,
    MerchantOrderId = "KTPay-DotNet-2771838446527563693",
    Amount = "100"
};
request.SetHashData(envConfig.Password);

Response

{
  "result": {
    "orderId": 203418364,
    "merchantOrderId": "KTPay-DotNet-2771838446527563693"
  },
  "success": true,
  "responseCode": "00",
  "responseMessage": "OTORİZASYON VERİLDİ",
  "businessKey": 202406079999000000041752195,
  "transactionTime": 1717779742
}

İşlem Sorgulama

Request

var request = new GetTransactionRequest() {
    Language = Language.TR.GetValue(),
    MerchantId = Convert.ToInt32(envConfig.MerchantId),
    CustomerId = Convert.ToInt32(envConfig.CustomerId),
    Username = envConfig.Username,
    OrderId = 203418364
};
request.SetHashData(envConfig.Password);

Response

{
  "result": {
    "merchantId": 496,
    "posTerminalId": "VP008759",
    "orderId": 203418364,
    "merchantOrderId": "KTPay-DotNet-2771838446527563693",
    "cardHolderName": "JOHN DOE",
    "cardNumber": "51889619****2544",
    "cardType": "MasterCard",
    "transactionTime": "2024-06-07T16:45:26.313",
    "isCancellable": 0,
    "isRefundable": 0,
    "isPartialRefundable": 0,
    "orderStatus": "Satış (1)",
    "lastOrderStatus": "İptal (6)",
    "orderType": "Peşin (1)",
    "transactionStatus": "Basarılı (1)",
    "firstAmount": 1,
    "drawbackAmount": 0,
    "cancelAmount": 1,
    "closedAmount": 0,
    "fec": "TRY (0949)",
    "installmentCount": 0,
    "transactionSecurity": "3d İşlem (3)",
    "responseCode": "00",
    "responseExplain": "İşlem gerçekleştirildi.",
    "batchId": 548,
    "endOfDayStatus": "Açık (1)",
    "endOfDayTime": null,
    "provisionNumber": "136525",
    "transactions": [
      {
        "orderStatus": "Satış (1)",
        "transactionTime": "2024-06-07T16:47:37.07",
        "batchId": 548,
        "provisionNumber": "136525",
        "rrn": "415916236400",
        "stan": "236400",
        "transactionStatus": "Basarılı (1)"
      },
      {
        "orderStatus": "İptal (6)",
        "transactionTime": "2024-06-07T17:02:19.923",
        "batchId": 548,
        "provisionNumber": "136525",
        "rrn": "415917236401",
        "stan": "236401",
        "transactionStatus": "Basarılı (1)"
      }
    ]
  },
  "success": true,
  "responseCode": "Successfull",
  "responseMessage": "İşleminiz başarıyla gerçekleştirildi.",
  "businessKey": 202406079999000000041789973,
  "transactionTime": 1717779814
}

İşlem Listeleme

Request

var request = new GetTransactionsRequest() {
    Language = Language.TR.GetValue(),
    MerchantId = Convert.ToInt32(envConfig.MerchantId),
    CustomerId = Convert.ToInt32(envConfig.CustomerId),
    Username = envConfig.Username,
    OrderId = 203418364, // Opsiyonel filtre
    MerchantOrderId = "KTPay-DotNet-2771838446527563693", // Opsiyonel filtre
    OrderStatus = 6, // Opsiyonel filtre
    BatchId = 548, // Opsiyonel filtre
    StartDate = new DateTime(DateTime.Now.Year, 1, 1), // Opsiyonel filtre
    EndDate = new DateTime(DateTime.Now.Year, 12, 31) // Opsiyonel filtre
};
request.SetHashData(envConfig.Password);

Response

{
  "result": {
    "transactions": [
      {
        "merchantId": 496,
        "posTerminalId": "VP008759",
        "orderId": 203418364,
        "merchantOrderId": "KTPay-DotNet-2771838446527563693",
        "cardHolderName": "JOHN DOE",
        "cardNumber": "51889619****2544",
        "cardType": "MasterCard",
        "transactionTime": "2024-06-07T16:45:26.313",
        "isCancellable": 0,
        "isRefundable": 0,
        "isPartialRefundable": 0,
        "orderStatus": "Satış (1)",
        "lastOrderStatus": "İptal (6)",
        "orderType": "Peşin (1)",
        "transactionStatus": "Basarılı (1)",
        "firstAmount": 1,
        "drawbackAmount": 0,
        "cancelAmount": 1,
        "closedAmount": 0,
        "fec": "TRY (0949)",
        "installmentCount": 0,
        "transactionSecurity": "3d İşlem (3)",
        "responseCode": "00",
        "responseExplain": "İşlem gerçekleştirildi.",
        "batchId": 548,
        "endOfDayStatus": "Açık (1)",
        "endOfDayTime": null,
        "provisionNumber": "136525"
      }
    ]
  },
  "success": true,
  "responseCode": "Successfull",
  "responseMessage": "İşleminiz başarıyla gerçekleştirildi.",
  "businessKey": 202406079999000000041844672,
  "transactionTime": 1717779917
}

Lisans

Bu proje MIT altında lisanslanmıştır. Ayrıntılar için LİSANS dosyasını inceleyin.

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
KTPay.Tests		KTPay.Tests
KTPay.Web		KTPay.Web
KTPay		KTPay
KTPay.sln		KTPay.sln
LICENSE		LICENSE
README-EN.md		README-EN.md
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

ktpay-dotnet

Gereksinimler

.NET Uyumluluğu

Kurulum

Örnek Kodlar

Satış

Taksitli Satış

Satış ve Taksitli Satış - Provizyon

İptal, İade ve Kısmi İade

İşlem Sorgulama

İşlem Listeleme

Lisans

About

Releases 1

Packages

Languages

License

KuveytTurk/ktpay-dotnet

Folders and files

Latest commit

History

Repository files navigation

ktpay-dotnet

Gereksinimler

.NET Uyumluluğu

Kurulum

Örnek Kodlar

Satış

Taksitli Satış

Satış ve Taksitli Satış - Provizyon

İptal, İade ve Kısmi İade

İşlem Sorgulama

İşlem Listeleme

Lisans

About

Resources

License

Stars

Watchers

Forks

Releases 1

Packages 0

Languages

Packages