EncoreBilisim.Eps 1.6.1

Encore Eps Library

Encore Bilisim yazılımları için ortak Eps ( Ödeme ) kütüphanesi

Nuget paketi:

dotnet add package EncoreBilisim.Eps

Paketin projeye eklenmesi

Eps Event Provider

Kütüphaneyi kullanmak için öncelkle EPS'den gelecek bilgi isteklerini karşılayacak bir EpsEventProvider classı yaratmak gerekiyor. Bu class eps den gelen bildirimleri ( kartı okutun, bankaya bağlanıyor. vs ) kullanıcıya göstermeli, ve kullanıcıdan alınması gereken bilgileri alabilmelidir ( kullanılacak puan tutarı, OTP vs. )

Basit bir Console Provider örneği:

using Encore.Eps;
using Encore.Eps.Models.EpsNotification;

namespace EpsTest
{
    internal class ConsoleEventProvider : IEpsEventProvider
    {
        public Task NotifyMessage(EpsNotifyDataRequest request)
        {
            Console.WriteLine(request.Message);
            return Task.CompletedTask;
        }

        public Task<EpsPromptDataResult> PromptData(EpsPromptDataRequest request)
        {
            Console.WriteLine(request.Title + request.Data );
            if(request.Points != null) { 
                foreach(var point in request.Points)
                {
                    Console.WriteLine($"{point.Definition} : {point.Amount}");
                }
            }
            EpsPromptDataResult result = new()
            {
                Data = Console.ReadLine()
            };
            return Task.FromResult(result);
        }
    }
}

Builder Class ile EpsManager oluşturma

Eps işlemleri için öncellikle EpsBuilder kullanılarak bir EPS Manager oluşturulur. EpsBuiilder ile Create metodu kullanılarak önce EventProvider tanımlanır.

EpsBuilder.Create(epsEventProvider);

Sonrasında Log classs ı eklemek için

EpsBuilder.Create(eventProvider:epsEventProvider)
    .WithLogger(NullLogger.Instance);

Daha Sonra herhangi bir IEpsProvider interface ini implemente eden bir provider eklenebilir.

IEpsProvider interface tanımı:

public interface IEpsProvider
{   string ProviderId { get; }
    Task<PayResponse> Pay(PayRequest payRequest, CancellationToken cancellationToken = default);
}

Örnek bir provider şu şekilde eklenir:

IEpsProvider walletProvider = new EWalletProvider();
EpsBuilder.Create(eventProvider:epsEventProvider)
    .WithLogger(NullLogger.Instance)
    .WithProvider(walletProvider);

Son olarak Build() metodu ile EpsManager yaratılır

IEpsManager eps = EpsBuilder.Create(eventProvider:epsEventProvider)
    .WithLogger(NullLogger.Instance)
    .WithProvider(walletProvider)
    .Build();

Microsoft Dependency Injection ile EpsManager oluşturma

IServiceCollection extention metodu kullanılarak service collectiona eps manager eklenir

services.AddEpsService(Configuration,epsEventProvider);

Providerlar

Chippin Provider

Nuget paketi:

dotnet add package EncoreBilisim.Eps.Chippin

Chippin eklentisi ile birlikte aşağıdaki şekilde chippin kullanımı eklenebilir <br> EncoreBilisim.Eps.Chippin<br> Chippin Provider ının provider id si "chippin" dir.

Builder

.WithChippin(c =>
    {
        c.Url = "https://test.chippin.com/services/api/";
        c.Credentials = new()
        {
            UserName ="encore_ws",
            HashedPassword = "C9E4EEA24AFF6F7E45B34F01BB1A8742"
        };
    })

Dependency Injection

services.AddChippin(Configuration);

appsettings.json dosyasına ise şu şekilde konfigurasyon yapılmalıdır:

  "Chippin": {
    "StatusPeriod": 1,
    "Timeout": 90,
    "Url": "https://test.chippin.com/services/api/",
    "Credentials": {
      "UserName": "encore_ws",
      "HashedPassword": "C9E4EEA24AFF6F7E45B34F01BB1A8742"
    }
  }

Ingenico EftPos Provider

Ingenico için ve diğer eftpos cihazları için EncoreBilisim.Eft.Device paketi kullanılır. <br> Bu paket Eps içinde builtin olarak vardır. Ayrı bir pakete gerek yoktur. EftPos providerı tanımlanır ve içersine bir ingenico device eklenir. Her device için bir PosId değeri verilir. Bu değer eftpos provider çağırılırken kullanılmak istenen pos chazını gösterir.

Genel EftPos providerının provider id si "ortakpos" dur.

Builder

PosSettings ingenicoSettings = new();
ingenicoSettings.IngenicoInterface.connection.szIP = "192.168.88.57";
ingenicoSettings.IngenicoInterface.connection.Port = 7500;
ingenicoSettings.IngenicoInterface.connection.IsTcpConnection = 1;
ingenicoSettings.IngenicoInterface.DefaultBankId = 10;

    .WithEftPos(c => c.AddDevice(posId:1, IngenicoPos.Create(ingenicoSettings)))

Dependency Injection

Her hangi bir eklentiye gerek yoktur. Eps servisi ile otomatik eklenir

appsettings.json dosyasına ise şu şekilde konfigurasyon yapılmalıdır:

 "IngenicoDevices": [
    {
      "PosId": 1,
      "Settings": {
        "IngenicoInterface": {
          "connection": {
            "szIP": "192.168.88.57",
            "Port": "7500",
            "IsTcpConnection": 1
          },
          "info": {
            "ImpProDllLogPath": "c:\\Encore\\Log\\Eps"
          },
          "DefaultBankId": 62
        }
      }
    }
  ],

Ödeme Alma

Providerlar tanımlandıktan sonra, artık Eps ödemeleri alınabilir. İstek yapılırken PayRequest içersindeki ProviderId alanı doldurularak ilgili providerın ödemeyi alması sağlanır.

var payResponse = await eps.Pay(new PayRequest()
{
    Amount = 1.3M,
    Id = Guid.NewGuid().ToString(),
    ProviderId = "ortakpos",
    PosId = 1,
});

Yukarıdaki örnekte ortak pos providerı kullanılarak 1 numaralı pos cihazından 1.30 ₺ ödeme onayı alınacaktır

Not:Ödeme işlemi sırasında IEpsEventProvider kullanılarak bilgilendirme mesajları gönderilebilir, veya kullanıcıdan bilgi girişi istenebilir. Fakat işlem sonunda cevap olarak PayResponse dönecektir