Sanal POS Çözümleri

Sanal POS, online mağazanızda yerli ya da yabancı kart sahiplerine satış yapmanızı sağlar. Sanal POS kullanarak ulaştığınız müşterilerin sayısını artırabilir, e-ticaret operasyonlarınızı kolaylaştırırsınız.

NomuPay olarak size farklı Bankaların Sanal POS yazılımlarını tek bir entegrasyon ve sözleşme ile kullanma imkanı sağlıyoruz. Böylece ayrı ayrı anlaşmalar yapmadan, farklı yazılımlarla uğraşmadan kolayca online ödeme almanın rahatlığını yaşarsınız.

NomuPay Ortak Ödeme Sayfası Entegrasyonu

  • NomuPay Ortak Ödeme Sayfası ile hızlı entegrasyon sağlayabilir ve ödeme almaya hemen başlayabilirsiniz.
  • 3D Secure ve Non-3D Secure ödeme opsiyonları desteklenmektedir.
  • Sayfa iFrame ve Pop-up ile kullanılabilir.
  • Duyarlı tasarım yapısı sayesinde web tarayıcılarıyla ve mobil cihazlar ile uyumludur.
  • Türkçe, İngilizce, Almanca, Rusça, Arapça, İspanyolca ve Fransızca olmak üzere 7 adet dil desteklenmektedir.
  • Kart numarası ve CVV değeri açık ya da maskeli olarak gösterilebilir.
  • Peşin ve taksitli ödeme seçenekleri sayfada gösterilebilir. Gösterilmek istenen peşin ve taksit seçeneklerine, API aracılığıyla üye işyeri tarafından karar verilebilir.
  • Türk Lirası (TRY), ABD Doları Doları (USD), Euro (EUR), İngiliz Sterlini (GBP) ve Rus Rublesi (RUB) olmak üzere 5 adet döviz cinsi desteklenmektedir.
  • Yabancı kartlar ile ABD Doları (USD), Euro (EUR), İngiliz Sterlini (GBP) ve Rus Rublesi (RUB) cinsinden işlemler desteklenmektedir.
  • PCI DSS uyumluluğu sayesinde kart saklama hizmeti desteklenmektedir. Ödeme almadan ya da ödeme işlemi sırasında kart kaydedilebilir.
  • Kredi kartı, banka kartı ve ön ödemeli (prepaid) kartlar desteklenmektedir.
  • Visa, Mastercard, TROY kartlar ile işlem gerçekleştirilebilmektedir. American Express (AMEX) kartlar ise henüz desteklenmemektedir.
  • Aylık, haftalık veyıllık gibi opsiyonları bulunan tekrarlayan ödeme sistemi kullanılabilir. Türk Lirası (TL), ABD Doları (USD) ve Euro (EUR) cinsinden tekrarlayan ödeme alınabilir.
  • NomuPay Ortak Ödeme Sayfası’nın tasarımı değiştirilemez.

3D Secure İle Ödeme

NomuPay Ortak Ödeme Sayfası 3D Secure ile ödeme entegrasyonu için Servis Girdi Parametreleri alanında belirtilen parametreleri, yayın adresinde ifade edilen Sanal POS Servisi’ne ait adrese iletmeniz gerekmektedir.


Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları


  • Input Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    ServiceType String Evet

    Sabit değer: "WDTicket"

    OperationType String Evet

    Sabit değer: "Sale3DSURLProxy"

    Token Token Sınıfı Evet

    Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.

    CustomerInfo CustomerInfo Sınıfı Hayır CustomerInfo Bilgileri parametreleri iç tabloda detaylandırılmıştır.
    Language String Hayır

    Ödeme sonucuna ait bilgilendirme e-mailin hangi dil opsiyonunda olacağını belirtir.
    TR: Türkçe
    EN: İngilizce

    Price Int Evet

    Ödeme tutarını belirten parametredir.Parametre değeri 100 ile çarpılarak ifade edilir.
    Örneğin 12,50 TL tutarında bir tahsilat gerçekleştirilmesi istenilir ise parametre 1250 şeklinde gönderilmelidir.

    MPAY String Hayır

    Üye işyeri tarafından belirlenen ve her bir sipariş için benzersiz değere sahip olması gereken parametredir. Üye işyeri belirlediği ve NomuPay’a ilettiği MPAY değerleri ile kolaylıkla siparişlerini takip edebilir. Maksimum karakter sınırı 400 olarak ifade edilmelidir.

    CurrencyCode String Evet

    Üye işyeri tarafından tahsilatın yapılacağı döviz cinsini belirleyen parametredir.
    Örneğin:TRY, EUR, USD, GBP, RUB

    Description String Evet

    Tahsilatı yapılan işlemin açıklamasını belirtir.

    ErrorURL String Evet

    Başarısız ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir. Son kullanıcı 3D Secure doğrulama adımı sonrasında bu sayfaya yönlendirilecektir.

    SuccessURL String Evet

    Başarılı ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir. Son kullanıcı 3D Secure doğrulama adımı sonrasında bu sayfaya yönlendirilecektir.

    ExtraParam String Hayır

    Ek opsiyonları belirtmek için kullanılan parametredir.
    Dil opsiyonları ve maskeli gösterim ExtraParam parametresi ile sağlanır. Kullanım iç tabloda detaylandırılmıştır.

    PaymentContent String Evet

    Tahsilatı yapılacak ürüne ait işlemin içeriğini belirten parametredir.

    PaymentTypeId Int Hayır

    Ödeme işleminin tipini belirten parametredir.
    1: Tek Çekim
    2: Aylık Abonelik
    3: Haftalık Abonelik
    18: Yıllık Abonelik
    19: 60 Günlük Abonelik
    20: 90 Günlük Abonelik
    21: 180 Günlük Abonelik

    InstallmentOptions Int Hayır

    Taksit sayısını tipini belirten parametredir.
    0: Tek Çekim
    3: 3 taksit
    6: 6 taksit
    9: 9 taksit
    12: 12 taksit

    CardTokenization CardTokenization Sınıfı Hayır CardTokenization Bilgileri parametreleri iç tabloda detaylandırılmıştır. Kredi kartı işlemi sırasında, işlemi gerçekleştiren kartın NomuPay sisteminde kaydedilmesi isteniyorsa belirtilen parametre iletilmelidir.
  • Token Bilgileri
    Parametre Adı Veri Tipi Açıklama
    UserCode String

    NomuPay tarafından atanan üye iş yeri numarası

    Pin String

    NomuPay tarafından atanan pin

  • CustomerInfo Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    CustomerName String Evet

    Bilgilendirme yapılacak kişinin ad bilgisi

    CustomerSurname String Evet

    Bilgilendirme yapılacak kişinin soyad bilgisi

    CustomerEmail String Evet

    Bilgilendirme yapılacak kişinin e-posta adresi

  • CardTokenization Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    RequestType Int Evet

    0 veya 1 değeri olarak iletilebilir.
    0: Kart kaydedilmez
    1: Kart kaydedilir

    CustomerId String Evet

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir.

    ValidityPeriod Int Evet

    Token kaydına ait geçerlilik süresini belirtir. Daima 0 gönderilir.

  • ExtraParam Parametre Bilgisi
    Parametre Adı Açıklama
    DefLang

    TR – Türkçe
    EN – İngilizce
    DE – Almanca
    AR – Arapça
    ES – İspanyolca
    FR – Fransızca

    NomuPay Ortak Ödeme Sayfasını İngilizce dilinde kullanmak istiyorsanız
    DefLang=EN
    Şeklinde parametreyi ifade etmeniz yeterli olacaktır.

    IsCCMasked

    Kredi kartı numarasının ödeme ekranında maskeli şekilde ifade edilmesini isterseniz parametrenin
    IsCCMasked=1
    belirtilmesi durumunda kredi kartı numarası ödeme sayfasında maskeli belirtilir.

    IsCVVMasked

    CVV numarasının ödeme ekranında maskeli gözükmesini isterseniz parametre
    IsCVVMasked=1 belirtilmesi durumunda CVV numarası ödeme sayfasında maskeli ifade edilir.

    IsCCMasked& IsCVVMasked

    Kredi kartı numarasının ve CVV numarası beraber maskeli şekilde ifade edilmesini talep ederseniz parametreyi
    IsCCMasked=1&IsCVVMasked=1
    belirtmeniz gerekmektedir.

Servis Çıktı Parametreleri


  • Servis Çıktı Parametreleri
    Parametre Adı Veri Tipi Açıklama
    StatusCode Int

    3D ile ödeme işlemi başlatılabilme durumu belirtilir.
    0: Başarılı
    1: Başarısız

    ResultCode String

    3D ile ödeme işlem isteğinin NomuPay’a iletimi belirtilir.

    ResultMessage String

    ResultCode değerinin açıklamasıdır. Başarılı veya başarısız şeklinde ifade edilir.

    RedirectUrl String

    Kredi kartı bilgilerinin alınabilmesi için son kullanıcı bu URL’ye yönlendirilmelidir.

3D Secure Olmadan (Non-3DS) Ödeme

NomuPay Ortak Ödeme Sayfası 3D Secure olmadan ödeme entegrasyonu için Servis Girdi Parametreleri alanında belirtilen parametreleri, yayın adresinde ifade edilen Sanal POS Servisi’ne ait adrese iletmeniz gerekmektedir.


Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları


  • Input Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    ServiceType String Evet

    Sabit değer: "WDTicket"

    OperationType String Evet

    Sabit değer: "SaleURLProxy"

    Token Token Sınıfı Evet

    Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.

    CustomerInfo CustomerInfo Sınıfı Hayır CustomerInfo Bilgileri parametreleri iç tabloda detaylandırılmıştır.
    Language String Hayır

    Ödeme sonucuna ait bilgilendirme e-mailin hangi dil opsiyonunda olacağını belirtir.
    TR: Türkçe
    EN: İngilizce

    Price Int Evet

    Ödeme tutarını belirten parametredir. Parametre değeri 100 ile çarpılarak ifade edilir.
    Örneğin 12,50 TL tutarında bir tahsilat gerçekleştirilmesi istenilir ise parametre 1250 şeklinde gönderilmelidir.

    MPAY String Hayır

    Üye işyeri tarafından belirlenen ve her bir sipariş için benzersiz değere sahip olması gereken parametredir. Üye işyeri belirlediği ve NomuPay’a ilettiği MPAY değerleri ile kolaylıkla siparişlerini takip edebilir. Maksimum karakter sınırı 400 olarak ifade edilmelidir.

    CurrencyCode String Evet

    Üye işyeri tarafından tahsilatın yapılacağı döviz cinsini belirleyen parametredir.
    Örneğin: TRY, EUR, USD, GBP, RUB

    Description String Evet

    Tahsilatı yapılan işlemin açıklamasını belirtir.

    ErrorURL String Evet

    Başarısız ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir.

    SuccessURL String Sınıfı Evet Başarılı ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir.
    ExtraParam String Sınıfı Hayır Ek opsiyonları belirtmek için kullanılan parametredir.
    Dil opsiyonları ve maskeli gösterim ExtraParam parametresi ile sağlanır. Kullanım iç tabloda detaylandırılmıştır.
    PaymentContent String Evet

    Tahsılatı yapılacak ürüne ait işlemin içeriğini belirten parametredir.

    PaymentTypeId Int Hayır

    Ödeme işleminin tipini belirten parametredir.
    1: Tek Çekim
    2: Aylık Abonelik
    3: Haftalık Abonelik
    18: Yıllık Abonelik
    19: 60 Günlük Abonelik
    20: 90 Günlük Abonelik
    21: 180 Günlük Abonelik

    InstallmentOptions Int Hayır

    Taksit sayısını tipini belirten parametredir.
    0: Tek Çekim
    3: 3 taksit
    6: 6 taksit
    9: 9 taksit
    12: 12 taksit

    CardTokenization CardTokenization Sınıfı Hayır

    CardTokenization Bilgileri parametreleri iç tabloda detaylandırılmıştır. Kredi kartı işlemi sırasında, işlemi gerçekleştiren kartın NomuPay sisteminde kaydedilmesi isteniyorsa belirtilen parametre iletilmelidir.

  • Token Bilgileri
    Parametre Adı Veri Tipi Açıklama
    UserCode String

    NomuPay tarafından atanan üye iş yeri numarası

    Pin String

    NomuPay tarafından atanan pin

  • CustomerInfo Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    CustomerName String Evet

    Bilgilendirme yapılacak kişinin ad bilgisi

    CustomerSurname String Evet

    Bilgilendirme yapılacak kişinin soyad bilgisi

    CustomerEmail String Evet

    Bilgilendirme yapılacak kişinin e-mail adresi

  • CardTokenization Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    RequestType Int Evet

    0 veya 1 olarak iletilebilir.
    0: Kart kaydedilmez
    1: Kart kaydedilir

    CustomerId String Evet

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir.

    ValidityPeriod Int Evet

    Token kaydına ait geçerlilik süresini belirtir. Daima 0 gönderilir.

  • ExtraParam Parametre Bilgisi
    Parametre Adı Açıklama
    DefLang

    TR – Türkçe
    EN – İngilizce
    DE – Almanca
    AR – Arapça
    ES – İspanyolca
    FR – Fransızca

    NomuPay Ortak Ödeme Sayfasını İngilizce dilinde kullanmak istiyorsanız
    DefLang=EN
    Şeklinde parametreyi ifade etmeniz yeterli olacaktır.

    IsCCMasked

    Kredi kartı numarasının ödeme ekranında maskeli şekilde ifade edilmesini isterseniz parametrenin
    IsCCMasked=1
    belirtilmesi durumunda kredi kartı numarası ödeme sayfasında maskeli belirtilir.

    IsCVVMasked

    CVV numarasının ödeme ekranında maskeli gözükmesini isterseniz parametre
    IsCVVMasked=1 belirtilmesi durumunda CVV numarası ödeme sayfasında maskeli ifade edilir.

    IsCCMasked& IsCVVMasked

    Kredi kartı numarasının ve CVV numarası beraber maskeli şekilde ifade edilmesini talep ederseniz parametreyi
    IsCCMasked=1&IsCVVMasked=1
    belirtmeniz gerekmektedir.

Servis Çıktı Parametreleri


  • Servis Çıktı Parametreleri
    Parametre Adı Veri Tipi Açıklama
    StatusCode Int

    Non-3Ds ile ödeme işlemi başlatılabilme durumu belirtilir.
    0: Başarılı
    1: Başarısız

    ResultCode String

    Non-3Ds ile ödeme işlem isteğinin NomuPay’a iletimi belirtilir.

    ResultMessage String

    ResultCode değerinin açıklamasıdır. Başarılı veya başarısız şeklinde ifade edilir.

    RedirectUrl String

    NomuPay Ortak Ödeme Sayfası linki
    Kredi kartı bilgilerinin alınabilmesi için son kullanıcı bu URL’ye yönlendirilmelidir.

Üye İşyeri Ödeme Sayfası Entegrasyonu

  • Üye İşyeri Ödeme Sayfası’nın kullanımı için NomuPay’a yapılan Sanal POS başvurusunun olumlu sonuçlanması gerekmektedir.
  • Yıllık işlem adedi 20.000’in üzerinde olan ve sadece PCI DSS Level 4 sertifikasına sahip üye işyerleri, başvurularının olumlu sonuçlanması halinde, NomuPay servisleri aracılığıyla kendi tasarladıkları ödeme sayfalarını müşterilerine sunabilirler. Sertifikası olmayan üye işyerleri ise NomuPay Ortak Ödeme Sayfası’nı kullanmak durumundadır.
  • Üye İşyeri Ödeme Sayfası’nda 3D Secure ve Non-3D Secure ödeme opsiyonları desteklenmektedir.
  • Türk Lirası (TRY), ABD Doları (USD), Euro (EUR), İngiliz Sterlini (GBP) ve Rus Rublesi (RUB) olmak üzere 5 adet döviz cinsi desteklenmektedir.
  • Peşin ve taksitli ödeme seçenekleri sayfada gösterilebilir. Gösterilmek istenen peşin ve taksit seçeneklerine, API aracılığıyla üye işyeri tarafından karar verilebilir.
  • Visa, Mastercard, TROY kartlar ile işlem gerçekleştirilebilmektedir. American Express (AMEX) kartlar ise henüz desteklenmemektedir.
  • Aylık, haftalık ve yıllık gibi opsiyonları bulunan tekrarlayan ödeme sistemi kullanılabilir. Türk Lirası (TRY), ABD Doları (USD) ve Euro (EUR) cinsinden tekrarlayan ödeme alınabilir.

3D Secure İle Ödeme Yöntemi

Üye İşyeri Ödeme Sayfası 3D Secure ile ödeme entegrasyonu için Servis Girdi Parametreleri alanında belirtilen parametreleri, yayın adresinde ifade edilen Sanal POS Servisi’ne ait adrese iletmeniz gerekmektedir.


Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları


  • Input Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    ServiceType String Evet

    Sabit değer: "CCProxy"

    OperationType String Evet

    Sabit değer: "Sale3DSEC"

    Token Token Sınıfı Evet

    Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.

    CreditCardInfo CreditCardInfo Sınıfı Evet CreditCardInfo Bilgileri parametreleri iç tabloda detaylandırılmıştır.
    CustomerInfo CustomerInfo Sınıfı Hayır CustomerInfo Bilgileri parametreleri iç tabloda detaylandırılmıştır.
    Language String Hayır

    Ödeme sonucuna ait bilgilendirme e-mailin hangi dil opsiyonunda olacağını belirtir.
    TR: Türkçe
    EN: İngilizce

    CardTokenization CardTokenization Sınıfı Evet

    CardTokenization Bilgileri parametreleri iç tabloda detaylandırılmıştır. Kredi kartı işlemi sırasında,işlemi gerçekleştiren kartın NomuPay sisteminde kaydedilmesi isteniyorsa belirtilen parametre iletilmelidir.

    MPAY String Hayır

    Üye işyeri tarafından belirlenen ve her bir sipariş için benzersiz değere sahip olması gereken parametredir.Üye işyeri belirlediği ve NomuPay’a ilettiği MPAY değerleri ile kolaylıkla siparişlerini takip edebilir. Maksimum karakter sınırı 400 olarak ifade edilmelidir.

    CurrencyCode String Evet

    Üye işyeri tarafından tahsilatın yapılacağı döviz cinsini belirleyen parametredir.
    Örneğin: TRY, EUR, USD, GBP, RUB

    Port String Hayır

    Ödeme işlemini gerçekleştiren son kullanıcıya ait port bilgisini belirtir.

    IPAddress String Evet

    Ödeme işlemini gerçekleştiren son kullanıcıya ait IP adresi bilgisini belirtir.

    PaymentContent String Evet

    Tahsilatı yapılacak ürüne ait işlemin içeriğini belirten parametredir.

    InstallmentCount Int Evet

    Taksit sayısını tipini belirten parametredir.
    0: Tek Çekim
    3: 3 taksit
    6: 6 taksit
    9: 9 taksit
    12: 12 taksit

    ErrorURL String Evet

    Başarısız ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir. Son kullanıcı 3D Secure doğrulama adımı sonrasında bu sayfaya yönlendirilecektir.

    SuccessURL String Evet

    Başarılı ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir. Son kullanıcı 3D Secure doğrulama adımı sonrasında bu sayfaya yönlendirilecektir.

    Description String Hayır

    Tahsilatı yapılan işlemin açıklamasını belirtir.

    ExtraParam String Hayır

    Ek opsiyonları belirtmek için kullanılan parametredir.
    Boş bırakılmalıdır.

    PaymentTypeId Int Hayır

    Ödeme işleminin tipini belirten parametredir.
    1: Tek Çekim
    2: Aylık Abonelik
    3: Haftalık Abonelik
    18: Yıllık Abonelik
    19: 60 Günlük Abonelik
    20: 90 Günlük Abonelik
    21: 180 Günlük Abonelik

  • Token Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    UserCode String Evet

    NomuPay tarafından atanan üye iş yeri numarası

    Pin Evet Evet

    NomuPay tarafından atanan pin

  • Credit Card Info Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    CreditCardNo String Evet

    Tahsilatın gerçekleşeceği kredi kartı numarasını belirtir. ‘540011111111111’ formatında iletilmelidir.

    OwnerName String Evet

    Kredi kartı üzerinde yer alan Ad ve Soyad bilgisini belirtir. ‘John Doe’ veya ‘JOHN DOE’ formatında iletilmelidir.

    ExpireYear Int Evet

    Kredi kartı geçerlilik tarihine ait yıl değeridir. ‘2020 formatında iletilmelidir.

    ExpireMonth Int Evet

    Kredi kartı geçerlilik tarihine ait ay değeridir. ’07 veya 12’ formatında iletilmelidir.

    Cvv String Evet

    Kredi kartının arka yüzünde yer alan CVV bilgisidir.

    Price Int Evet

    Ödeme tutarını belirten parametredir. Parametre değeri 100 ile çarpılarak ifade edilir.
    Örneğin 12,50 TL tutarında bir tahsilat gerçekleştirilmesi istenilir ise parametre 1250 şeklinde gönderilmelidir.

  • Card Tokenization Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    RequestType Int Evet

    0 veya 1 değeri olarak iletilebilir.
    0: Kart kaydedilmez
    1: Kart kaydedilir

    CustomerId String Evet

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir.

    ValidityPeriod Int Evet

    Token kaydına ait geçerlilik süresini belirtir. Daima 0 gönderilir.

    CCTokenId Guid Evet

    Kaydedilen kart numarasına karşılık gelen NomuPay token değeridir. Eğer parametre değere sahip ise kredi kartı bilgilerinin girilmesine gerek yoktur.

  • CustomerInfo Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    CustomerName String Evet

    Bilgilendirme yapılacak kişinin ad bilgisi

    CustomerSurname String Evet

    Bilgilendirme yapılacak kişinin soyad bilgisi

    CustomerEmail String Evet

    Bilgilendirme yapılacak kişinin e-mail adresi

Servis Çıktı Parametreleri

  • Servis Çıktı Parametreleri
    Parametre Adı Veri Tipi Açıklama
    StatusCode Int

    3D ile ödeme işlemi başlatılabilme durumu belirtilir.
    0: Başarılı
    1: Başarısız

    ResultCode String

    3D ile ödeme işlem isteğinin NomuPay’a iletimi belirtilir.

    ResultMessage String

    ResultCode değerinin açıklamasıdır. Başarılı veya başarısız şeklinde ifade edilir.

    OrderObjectId Guid

    NomuPay sipariş numarasını belirtir. Her sipariş için bu değer benzersizdir.

    LastTransactionDate String

    İşlemin tarihini belirtir.

    MaskedCreditCardNumber String

    Ödeme işlemi yapılması istenilen kredi kartı numarasının maskeli format ile gösterilmesidir.

    MPAY String

    Üye işyerinin ödeme isteğinde belirttiği MPAY değeridir.

    SubscriberId String

    Tahsilat abonelik kurgusu içeriyor ise NomuPay benzersiz bir değer gönderir. Tekil satış işlemlerde daima ‘00000000-0000-0000-0000-000000000000’ iletilir.

    RedirectUrl String

    Ödeme isteğinde belirtilen kredi kartı bilgilerinin 3D Secure doğrulama sağlayabilmesi için son kullanıcının yönlendirileceği URL bilgisidir.
    Son kullanıcı bu URL’ye yönlendirilmelidir.

3D Secure Olmadan Ödeme

Üye İşyeri Ödeme Sayfası 3D Secure olmadan ödeme entegrasyonu için Servis Girdi Parametreleri alanında belirtilen parametreleri, yayın adresinde ifade edilen Sanal POS Servisi’ne ait adrese iletmeniz gerekmektedir.


Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları


  • Input Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    ServiceType String Evet

    Sabit değer: "CCProxy"

    OperationType String Evet

    Sabit değer: "Sale"

    Token Token Sınıfı Evet

    Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.

    CreditCardInfo CreditCardInfo Sınıfı Evet CreditCardInfo Bilgileri parametreleri iç tabloda detaylandırılmıştır.
    CustomerInfo CustomerInfo Sınıfı Hayır CustomerInfo Bilgileri parametreleri iç tabloda detaylandırılmıştır.
    Language String Hayır

    Ödeme sonucuna ait bilgilendirme e-mailin hangi dil opsiyonunda olacağını belirtir.
    TR: Türkçe
    EN: İngilizce

    CardTokenization CardTokenization Sınıfı Evet

    CardTokenization Bilgileri parametreleri iç tabloda detaylandırılmıştır. Kredi kartı işlemi sırasında,işlemi gerçekleştiren kartın NomuPay sisteminde kaydedilmesi isteniyorsa belirtilen parametre iletilmelidir.

    MPAY String Hayır

    Üye işyeri tarafından belirlenen ve her bir sipariş için benzersiz değere sahip olması gereken parametredir.Üye işyeri belirlediği ve NomuPay’a ilettiği MPAY değerleri ile kolaylıkla siparişlerini takip edebilir. Maksimum karakter sınırı 400 olarak ifade edilmelidir.

    CurrencyCode String Evet

    Üye işyeri tarafından tahsilatın yapılacağı döviz cinsini belirleyen parametredir.
    Örneğin: TRY, EUR, USD, GBP, RUB

    Port String Hayır

    Ödeme işlemini gerçekleştiren son kullanıcıya ait port bilgisini belirtir.

    IPAddress String Evet

    Ödeme işlemini gerçekleştiren son kullanıcıya ait IP adresi bilgisini belirtir.

    PaymentContent String Evet

    Tahsilatı yapılacak ürüne ait işlemin içeriğini belirten parametredir.

    InstallmentCount Int Evet

    Taksit sayısını tipini belirten parametredir.
    0: Tek Çekim
    3: 3 taksit
    6: 6 taksit
    9: 9 taksit
    12: 12 taksit

    ErrorURL String Evet

    Başarısız ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir.

    SuccessURL String Evet

    Başarılı ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir.

    Description String Hayır

    Tahsilatı yapılan işlemin açıklamasını belirtir.

    ExtraParam String Hayır

    Ek opsiyonları belirtmek için kullanılan parametredir.
    Boş bırakılmalıdır.

    PaymentTypeId Int Hayır

    Ödeme işleminin tipini belirten parametredir.
    1: Tek Çekim
    2: Aylık Abonelik
    3: Haftalık Abonelik
    18: Yıllık Abonelik
    19: 60 Günlük Abonelik
    20: 90 Günlük Abonelik
    21: 180 Günlük Abonelik

  • Token Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    UserCode String Evet

    NomuPay tarafından atanan üye iş yeri numarası

    Pin Evet Evet

    NomuPay tarafından atanan pin

  • Credit Card Info Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    CreditCardNo String Evet

    Tahsilatın gerçekleşeceği kredi kartı numarasını belirtir. ‘540011111111111’ formatında iletilmelidir.

    OwnerName String Evet

    Kredi kartı üzerinde yer alan Ad ve Soyad bilgisini belirtir. ‘John Doe’ veya ‘JOHN DOE’ formatında iletilmelidir.

    ExpireYear Int Evet

    Kredi kartı geçerlilik tarihine ait yıl değeridir. ‘2020 formatında iletilmelidir.

    ExpireMonth Int Evet

    Kredi kartı geçerlilik tarihine ait ay değeridir. ’07 veya 12’ formatında iletilmelidir.

    Cvv String Evet

    Kredi kartının arka yüzünde yer alan CVV bilgisidir.

    Price Int Evet

    Ödeme tutarını belirten parametredir. Parametre değeri 100 ile çarpılarak ifade edilir.
    Örneğin 12,50 TL tutarında bir tahsilat gerçekleştirilmesi istenilir ise parametre 1250 şeklinde gönderilmelidir.

  • Card Tokenization Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    RequestType Int Evet

    0 veya 1 değeri olarak iletilebilir.
    0: Kart kaydedilmez
    1: Kart kaydedilir

    CustomerId String Evet

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir.

    ValidityPeriod Int Evet

    Token kaydına ait geçerlilik süresini belirtir. Daima 0 gönderilir.

    CCTokenId Guid Evet

    Kaydedilen kart numarasına karşılık gelen NomuPay token değeridir. Eğer parametre değere sahip ise kredi kartı bilgilerinin girilmesine gerek yoktur.

  • CustomerInfo Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    CustomerName String Evet

    Bilgilendirme yapılacak kişinin ad bilgisi

    CustomerSurname String Evet

    Bilgilendirme yapılacak kişinin soyad bilgisi

    CustomerEmail String Evet

    Bilgilendirme yapılacak kişinin e-mail adresi

Servis Çıktı Parametreleri


  • Servis Çıktı Parametreleri
    Parametre Adı Veri Tipi Açıklama
    StatusCode Int

    Ödeme işlemi başlatılabilme durumu belirtilir.
    0: Başarılı
    1: Başarısız

    ResultCode String

    Ödeme işlem isteğinin NomuPay’a iletimi belirtilir.

    ResultMessage String

    ResultCode değerinin açıklamasıdır. Başarılı veya başarısız şeklinde ifade edilir.

    OrderObjectId Guid

    NomuPay sipariş numarasını belirtir. Her sipariş için bu değer benzersizdir.

    LastTransactionDate String

    İşlemin tarihini belirtir.

    MaskedCreditCardNumber String

    Ödeme işlemi yapılması istenilen kredi kartı numarasının maskeli format ile gösterilmesidir.

    MPAY String

    Üye işyerinin ödeme isteğinde belirttiği MPAY değeridir.

    CCTokenId Guid

    Kaydedilen kart numarasına karşılık gelen NomuPay token değeridir.

    SubscriberId Guid

    Tahsilat abonelik kurgusu içeriyor ise NomuPay benzersiz bir değer gönderir. Tekil satış işlemlerde daima ‘00000000-0000-0000-0000-000000000000’ iletilir.

Sipariş Sonuç Bilgisi

3D Secure ile ödeme ve Non-3D Secure ödeme opsiyonuna ait ödeme isteklerinde; üye işyeri tarafından belirtilen ErrorURL ve SuccessURL adreslerine işlemin başarılı ya da başarısız olma sonucu işlemin detayıına aittabloda belirtilen parametreler ile iletilir. Üye işyeri, ilgili bilgileri başarılı ve başarısız sayfasında son kullanıcıya gösterebilir.Üye işyeri yönetim panelinizi kullanarak da siparişlerinizin sonucunu takip edebilirsiniz.

Parametre Adı Açıklama
OrderId

NomuPay sipariş numarasını belirtir. Her sipariş için bu değer benzersizdir.

MPAY

Üye işyerinin ödeme isteğinde belirttiği MPAY değeridir.

Statuscode

Tahsilat sonucunu belirtir.

ResultCode

Tahsilat sonucunun NomuPay tarafından belirlenen kodudur.

ResultMessage

Tahsilat sonucunun NomuPay tarafından belirlenen kodunun açıklamasıdır.

LastTransactionDate

İşlemin tarihini belirtir.

MaskedCCNo

Ödeme işlemi yapılması istenilen kredi kartı numarasının maskeli format ile gösterilmesidir.

CCTokenId

Kaydedilen kart numarasına karşılık gelen NomuPay token değeridir.

SubscriberId

Tahsilat abonelik kurgusu içeriyor ise NomuPay benzersiz bir değer gönderir. Tekil satış işlemlerde daima ‘00000000-0000-0000-0000-000000000000’ iletilir.

Kart Saklama Servisi(POS)

NomuPay, PCI DSS Level 1 sertifikaya sahiptir ve bu kapsamda kart saklama hizmeti de sunabilir.

Kart saklama altyapısında VISA, MasterCard ve Troy logolu kredi, banka ya da ön ödemeli yurt içi / yurt dışı kartlar saklanabilir.

Servis Girdi Parametreleri alanında belirtilen parametreleri yayın adresinde ifade edilen Sanal POS Servisi’ne ait adrese iletmeniz gerekmektedir. NomuPay Kart Saklama formu veya üye işyeri sayfası ile kart saklama opsiyonlarını kullanabilirsiniz.

NomuPay Kart Saklama Formu İle Kart Saklama


Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları


  • Input Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    ServiceType String Evet

    Sabit değer: "WDTicket"

    OperationType String Evet

    Sabit değer: "TokenizeCCURL"

    Token Token Sınıfı Evet

    Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.

    ErrorURL String Evet

    Başarısız kart kayıt işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir. Son kullanıcı kart kayıt adımı sonrasında bu sayfaya yönlendirilecektir.

    SuccessURL String Evet

    Başarılı kart kayıt işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir. Son kullanıcı kart kayıt adımı sonrasında bu sayfaya yönlendirilecektir

    CustomerId String Hayır

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir.

    IPAddress String Evet

    Son kullanıcıya ait IP adresi bilgisini belirtir.

    ValidityPeriod String Evet

    Token kaydına ait geçerlilik süresini belirtir. Daima 0 gönderilir.

  • Token Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    UserCode String Evet

    NomuPay tarafından atanan üye iş yeri numarası

    Pin Evet Evet

    NomuPay tarafından atanan pin

Servis Çıktı Parametreleri

  • Servis Çıktı Parametreleri
    Parametre Adı Veri Tipi Açıklama
    StatusCode Int

    İşlemi başlatılabilme durumu belirtilir.
    0: Başarılı
    1: Başarısız

    ResultCode String

    İşlem isteğinin NomuPay’a iletimi belirtilir.

    ResultMessage String

    ResultCode değerinin açıklamasıdır. Başarılı veya başarısız şeklinde ifade edilir.

    RedirectUrl String

    Kredi kartı bilgilerinin alınabilmesi için son kullanıcı bu URL’ye yönlendirilmelidir.

Üye İşyeri Sayfasında Kart Saklama


Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları


  • Input Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    ServiceType String Evet

    Sabit değer: "TokenizeCC"

    OperationType String Evet

    Sabit değer: "TokenizeCC"

    Token Token Sınıfı Evet

    Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.

    CreditCardNumber String Evet

    Kredi kartı numarasını belirtir. Kredi kartı formatı ‘5400XXXXXXXXXXXX’ olmalıdır.

    NameSurname String Evet

    Kredi kartı ad soyad bilgisini belirtir. Kredi kartı ad soyad bilgi formatı "John Doe" yada "JOHN DOE" şeklinde olmalıdır.

    CustomerId String Hayır

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir.

    ExpiryDate Int Evet

    Kredi kartı son kullanım tarihini belirtir. Kredi kartı son kullanım tarihi formatı 11/2017 olmalıdır.

    CVV Int Evet

    Kredi kartın CVV bilgi değerini belirdir.

    CustomerId String Hayır

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir.

    IPAddress String Evet

    Son kullanıcıya ait IP adresi bilgisini belirtir.

    ValidityPeriod String Evet

    Token kaydına ait geçerlilik süresini belirtir. Daima 0 gönderilir.

    Port String Evet

    Son kullanıcıya ait port bilgisini belirtir.

  • Token Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    UserCode String Evet

    NomuPay tarafından atanan üye iş yeri numarası

    Pin Evet Evet

    NomuPay tarafından atanan pin

Servis Çıktı Parametreleri


  • Servis Çıktı Parametreleri
    Parametre Adı Veri Tipi Açıklama
    StatusCode Int

    İşlemi başlatılabilme durumu belirtilir.
    0: Başarılı
    1: Başarısız

    ResultCode String

    İşlem isteğinin NomuPay’a iletimi belirtilir.

    ResultMessage String

    ResultCode değerinin açıklamasıdır. Başarılı veya başarısız şeklinde ifade edilir.

    TokenId String

    Kaydedilen kart numarasına karşılık gelen NomuPay token değeridir.

    CVV Int

    Kredi kartın CVV bilgi değerini belirdir.

    CustomerId String

    Üye işyeri tarafından belirtilen müşterilerine ait Id bilgisidir

    MaskedCreditCardNumber String

    Kredi Kartı numarasının maskelenmiş değerini belirtir.

BIN Sorgu Servisi(POS)

Servis Girdi Parametreleri alanında belirtilen parametreleri yayın adresinde ifade edilen Sanal POS Servisi’ne ait adrese iletmeniz gerekmektedir.NomuPay BIN’e ait özellikleri tarafınıza iletir.

Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları


  • Input Bilgileri
    Parametre Adı Veri Tipi Açıklama
    ServiceType String

    Sabit değer: "MerchantQueries"

    OperationType String

    Sabit değer: "BinQueryOperation"

    Token Token Sınıfı

    Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.

    Bin String

    Kredi kartı numaranızın ilk 6 hanesi

  • Token Bilgileri
    Parametre Adı Veri Tipi Zorunluluk Açıklama
    UserCode String Evet

    NomuPay tarafından atanan üye iş yeri numarası

    Pin Evet Evet

    NomuPay tarafından atanan pin

Servis Çıktı Parametreleri


  • Servis Çıktı Parametreleri
    Parametre Adı Veri Tipi Açıklama
    StatusCode Int

    İşlem sonucu
    0: Başarılı
    1: Başarısız

    InstallmentEnabled String

    True: Taksit yetkisi var
    False: Taksit yetkisi yok

    ResultCode String

    İşlem isteğinin NomuPay’a iletimi belirtilir.

    ResultMessage String

    ResultCode değerinin açıklamasıdır. Başarılı veya başarısız şeklinde ifade edilir.

    CardType String

    Kart Tipi
    DC->DebitCard
    CC->CreditCard
    PC->PrepaidCard

    IsCorporate Boolean

    False: Ticari Kart değil
    True: Ticari Kart

    IsVirtual Boolean

    True: Sanal Kart
    False: Sanal Kart değil

    Network String

    Mastercard/Amex/Visa/Troy

    BankCode Int

    Kartın Banka Kodu

    BankName String

    Kartın Banka Adı

Örnek Servis Çağrı Kodları