CP.VPOS

CP.VPOS: Sanal Pos Entegrasyonlarını Basitleştirin

CP.VPOS, Türkiye'deki birçok bankanın sanal pos entegrasyonlarını tek bir kod tabanı ile kullanmayı mümkün kılan .NET kütüphanesidir. Bu sayede geliştiriciler, her banka için ayrı ayrı kod yazmak zorunda kalmadan, tüm sanal pos işlemlerini tek bir kütüphane üzerinden gerçekleştirebilirler.

Kütüphanenin Özellikleri

• Tek Kod Tabanı: Farklı bankaların sanal pos entegrasyonları için ayrı ayrı kod yazmaya gerek kalmadan, tek bir kod tabanı ile tüm işlemleri gerçekleştirebilirsiniz.
• Basitleştirilmiş İşlem Akışı: Sanal pos işlemleri için gerekli tüm adımlar kütüphane tarafından otomatik olarak halledilir. Bu sayede kod yazma süreci oldukça basitleşir.
• 3D Güvenli Ödeme Desteği: 3D Güvenli Ödeme işlemleri için gerekli tüm adımlar kütüphane tarafından desteklenir.
• Geniş Banka Kapsamı: Akbank, Alternatif Bank, Anadolubank, Denizbank, QNB Finansbank, Finansbank Nestpay, Garanti BBVA, Halkbank, ING Bank, İş Bankası, Şekerbank, TEB, Türkiye Finans, Vakıfbank, Yapı Kredi ve Ziraat Bankası gibi birçok banka ile birlikte, Iyzico ve Sipay gibi ödeme kuruluşlarının da sanal pos entegrasyonları kütüphanede yer alır.
• .NET Uyumluluğu: Kütüphane, .NET Framework, .NET Core ve .NET MAUI da dahil olmak üzere tüm .NET sürümleriyle tam uyumludur. Bu sayede farklı projelerde kolayca entegre edilerek kullanılabilir.

Sürüm Notları

v2.3.0

• Tami sanal pos entegrasyonu eklendi.

v2.2.2

• Kart bin listesi güncellendi.

v2.2.1

• İş bankası test ortamı api adresleri güncellendi.

v2.2.0

• ZiraatPay ve VakıfPayS sanal pos entegrasyonları eklendi.

v2.1.1

• Nestpay bankalarında 3D'siz işlemlere sipariş numarası eklendi.

v2.1.0

• Vepara sanal pos entegrasyonu eklendi.

v2.0.1

• QNBpay, Paybull, Parolapara, IQmoney sanal poslarında tüm taksit seçenekleri sorgulama AllInstallmentQuery bug fix

v2.0.0

• Akbank yeni sanal pos altyapısı geliştirmesi yapıldı. Akbank aşamalı olarak sanal pos müşterilerini nestpay üzerinden kendi altyapsını geçiriyor. Halihazırda akbank kullananlar bu versiyona geçmeden önce yeni altyapı için erişim bilgilerini bankadan talep etmeliler veya eski (Nestpay) entegrasyonunu kullanmak isteyenler CP.VPOS.Services.BankService.AkbankNestpay veya 9046 kodu ile Nestpay üzerinden kullanabilirler.

Kütüphaneyi Nasıl Kullanabilirsiniz?

CP.VPOS kütüphanesini NuGet paket yöneticisi aracılığıyla projenize ekleyebilirsiniz. Kütüphanenin kullanımıyla ilgili aşağıda bulunan kod örneklerine göz atabilirsiniz.

https://www.nuget.org/packages/CP.VPOS

Package Manager:

Install-Package CP.VPOS

Dotnet CLI

dotnet add package CP.VPOS

Kullanılabilir Sanal POS'lar

Dokümanlar

Detaylı dokümanlara https://www.vpos.com.tr/docs adresinden ulaşabilirsiniz.

API Bilgilerinin ayarlanması - VirtualPOSAuth Class'ı

Alan açıklamaları:

Sanal POS bazlı alan açıklamaları:

3D'siz Direkt Satış İşlemi

payment3D.confirm = false gönderilmesi halinde 3D'siz çekim işlemi yapılır ve direkt olarak nihai sonucu döner.

VirtualPOSAuth _qnbPayTest = new VirtualPOSAuth
{
    bankCode = CP.VPOS.Services.BankService.QNBpay,
    merchantID = "20158",
    merchantUser = "07fb70f9d8de575f32baa6518e38c5d6",
    merchantPassword = "61d97b2cac247069495be4b16f8604db",
    merchantStorekey = "$2y$10$N9IJkgazXMUwCzpn7NJrZePy3v.dIFOQUyW4yGfT3eWry6m.KxanK",
    testPlatform = true
};

CustomerInfo customerInfo = new CustomerInfo
{
	taxNumber = "1111111111",
	emailAddress = "test@test.com",
	name = "cem",
	surname = "pehlivan",
	phoneNumber = "1111111111",
	addressDesc = "adres",
	cityName = "istanbul",
	country = CP.VPOS.Enums.Country.TUR,
	postCode = "34000",
	taxOffice = "maltepe",
	townName = "maltepe"
};

SaleRequest saleRequest = new SaleRequest
{
	invoiceInfo = customerInfo,
	shippingInfo = customerInfo,
	saleInfo = new SaleInfo
	{
		cardNameSurname = "test kart",
		cardNumber = "4022780520669303",
		cardExpiryDateMonth = 1,
		cardExpiryDateYear = 2050,
		cardCVV = "988",
		amount = (decimal)10,
		currency = CP.VPOS.Enums.Currency.TRY,
		installment = 1,
	},
	payment3D = new Payment3D
	{
		confirm = false
	},
	customerIPAddress = "1.1.1.1",
	orderNumber = Convert.ToInt32((DateTime.Now - new DateTime(1970, 1, 1)).TotalSeconds).ToString("X")
};


var resp = VPOSClient.Sale(saleRequest, _qnbPayTest);

3D Secure Satış İşlemi

payment3D.confirm = true gönderilmesi halinde 3D li satış işlemi başlatılır. 3D li işlemlerde payment3D.returnURL alanına 3D den gelecek olan cevabın iletilmesi istenen URL girilmelidir. Örneğin: https://localhost/Payment/VirtualPOS3DResponse.

VPOSClient.Sale metodundan dönen cevaptaki statu enum alanı RedirectURL veya RedirectHTML döner. statu RedirectURL ise message alanında client'ı yönlendirmeniz gereken url bulunur. statu RedirectHTML ise message alanında client'ın sayfasında çalıştırmanız gereken HTML bulunur.

Bu işlem sonrası client, banka 3D doğrulama sayfasına yönlendirilir. Bu sayfadaki işlem sonucunu banka, payment3D.returnURL alanında belirttiğimiz url e client'ın browserını kullanarak form post yöntemi ile döner.

3D den gelen form request body'sini Dictionary<string, object> e çevirip VPOSClient.Sale3DResponse methoduna gönderilmesi gerekmektedir. Bu işlem sonrası nihai sonuç döner.

VirtualPOSAuth _qnbPayTest = new VirtualPOSAuth
{
    bankCode = CP.VPOS.Services.BankService.QNBpay,
    merchantID = "20158",
    merchantUser = "07fb70f9d8de575f32baa6518e38c5d6",
    merchantPassword = "61d97b2cac247069495be4b16f8604db",
    merchantStorekey = "$2y$10$N9IJkgazXMUwCzpn7NJrZePy3v.dIFOQUyW4yGfT3eWry6m.KxanK",
    testPlatform = true
};

CustomerInfo customerInfo = new CustomerInfo
{
	taxNumber = "1111111111",
	emailAddress = "test@test.com",
	name = "cem",
	surname = "pehlivan",
	phoneNumber = "1111111111",
	addressDesc = "adres",
	cityName = "istanbul",
	country = CP.VPOS.Enums.Country.TUR,
	postCode = "34000",
	taxOffice = "maltepe",
	townName = "maltepe"
};

SaleRequest saleRequest = new SaleRequest
{
	invoiceInfo = customerInfo,
	shippingInfo = customerInfo,
	saleInfo = new SaleInfo
	{
		cardNameSurname = "test kart",
		cardNumber = "4022780520669303",
		cardExpiryDateMonth = 1,
		cardExpiryDateYear = 2050,
		cardCVV = "988",
		amount = (decimal)10,
		currency = CP.VPOS.Enums.Currency.TRY,
		installment = 1,
	},
	payment3D = new Payment3D
	{
		confirm = true,
		returnURL = "https://localhost/Payment/VirtualPOS3DResponse"
	},
	customerIPAddress = "1.1.1.1",
	orderNumber = Convert.ToInt32((DateTime.Now - new DateTime(1970, 1, 1)).TotalSeconds).ToString("X")
};


var resp = VPOSClient.Sale(saleRequest, _qnbPayTest);

3D Secure Satış İşlemi 2. Adım

public class PaymentController
{
    public async Task<IActionResult> VirtualPOS3DResponse()
    {
        Dictionary<string, object>? pairs = null;

        if (Request.Method == "GET")
            pairs = Request.Query.Keys.ToDictionary(k => k, v => (object)Request.Query[v]);
        else
            pairs = Request.Form.Keys.ToDictionary(k => k, v => (object)Request.Form[v]);   

        SaleResponse response = VPOSClient.Sale3DResponse(new Sale3DResponseRequest
        {
            responseArray = pairs
        }, _qnbPayTest);
    }
}