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: İngilizcePrice 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, RUBDescription 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 AbonelikInstallmentOptions Int Hayır Taksit sayısını tipini belirten parametredir.
0: Tek Çekim
3: 3 taksit
6: 6 taksit
9: 9 taksit
12: 12 taksitCardTokenization 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 kaydedilirCustomerId 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ızResultCode 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: İngilizcePrice 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, RUBDescription 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 AbonelikInstallmentOptions Int Hayır Taksit sayısını tipini belirten parametredir.
0: Tek Çekim
3: 3 taksit
6: 6 taksit
9: 9 taksit
12: 12 taksitCardTokenization 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 kaydedilirCustomerId 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ızResultCode 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: İngilizceCardTokenization 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, RUBPort 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 taksitErrorURL 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 kaydedilirCustomerId 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ızResultCode 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: İngilizceCardTokenization 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, RUBPort 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 taksitErrorURL 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 kaydedilirCustomerId 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ızResultCode 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ızResultCode 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ızResultCode 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ızInstallmentEnabled String True: Taksit yetkisi var
False: Taksit yetkisi yokResultCode 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->PrepaidCardIsCorporate Boolean False: Ticari Kart değil
True: Ticari KartIsVirtual Boolean True: Sanal Kart
False: Sanal Kart değilNetwork String Mastercard/Amex/Visa/Troy
BankCode Int Kartın Banka Kodu
BankName String Kartın Banka Adı