Mobil Ödeme Çözümleri
Mobil Ödeme, işlem tutarının cep telefonu faturasına yansıtılarak ya da hat bakiyesinden düşerek ödenmesini sağlayan bir ödeme yöntemidir. Böylece müşterileriniz, online mağazanızda ya da uygulamanızda sadece cep telefonu numaralarını kullanarak alışveriş yapabilir.
- NomuPay Ortak Ödeme Sayfası ile hızlı entegrasyon sağlayabilirsiniz.
- Sayfa Iframe ve Pop-up ile kullanılabilir.
- Responsive yapısı sayesinde web tarayıcıları ve mobil cihazlar ile uyumludur.
- Tek seferlik, aylık, haftalık ve yıllık gibi opsiyonları bulunan tekrarlayan ödeme sistemi kullanılabilir.
- NomuPay Ortak Ödeme Sayfası’nın tasarımı değiştirilemez.
- Mobil Ödeme çözüm yöntemi kullanan üye işyerlerimiz operatör onaylarından sonra güncel fiyatlarını kullanabilirler.
ÖNEMLİ: Operatör onay süreçleri hakkında belirli gün aralığı bildiremiyoruz. Siz değerli üye işyerlerimiz gibi NomuPay olarak biz de operator onaylarını beklemekteyiz.
NomuPay Ortak Ödeme Sayfası Entegrasyonu
NomuPay Ortak Ödeme Sayfası mobil ödeme entagrasyonu için Servis Girdi Parametreleri kısmında belirtilen parametreleri yayın adresinde ifade edilen Mobil Servis’e ait adrese iletmeniz gerekmektedir.SaleWithTicket methodu kullanılmalıdır.
NomuPay, Token bilgilerini üye işyerine iletir.Token bilgilerine sahip değilseniz NomuPay Entegrasyon ekibimizle integration@nomupay.com.tr e-posta adresi üzerinden iletişime geçebilirsiniz.
Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları
-
Input Bilgileri
Parametre Adı Veri Tipi Açıklama Token Token Sınıfı Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.
MPAY String Ü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.
Content String Tahsılatı yapılacak ürüne ait işlemin içeriğini belirten parametredir.
SendOrderResult bool İşlem Sonuç Servisi ile işlem sonuç bilgisi gönderim durumunu belirtir.
true: Bilgi gönderilsin
false: Bilgi gönderilmesinPaymentTypeId Int Ödeme işleminin tipini belirten parametredir.
- ‘1’ Tek çekim
- ‘2’ Aylık abonelik
- ‘3’ Haftalık abonelik
- ‘4’ 2 haftalık abonelik
- ‘5’ 3 aylık abonelik
- ‘6’ 6 aylık abonelik
- ‘7’ aylık denemeli
- ‘8’ haftalık denemeli
- ‘9’ 2 haftalık denemeli
- ‘10’ 3 aylık denemeli
- ‘11’ 6 aylık denemeli
- ‘13’ 30 günlük
- ‘14’ Günlük abonelik
- ‘18’ Yıllık abonelik
ReceivedSMSObjectId Guid Daima ‘00000000-0000-0000-0000-000000000000’ olarak gönderilmelidir.
ProductList List ProductList şeklinde ifade edilen MSaleProduct elemanlarını temsil eder. Liste içerisinde tek bir adet MSaleProduct elemanı bulunmalıdır. MSaleProduct bilgileri parametreleri iç tabloda detaylandırılmıştır.
SendNotificationSMS bool Ödeme sonucunda son kullanıcıya gönderilecek bilgi SMS’ine ait seçimi belirtir.
- true: Bilgi gönderilsin
- false: Bilgi gönderilmesin
OnSuccessfulSMS String SendNotificationSMS parametresi "True" olarak ifade edilmiş ise, ödemenin başarılı olması durumunda kullanıcıya gönderilecek bilgi SMSi'nin içeriğini belirtir.
Türkçe karakter kullanılmamalıdırOnErrorSMS String SendNotificationSMS parametresi "True" olarak ifade edilmiş ise, ödemenin başarısız olması durumunda kullanıcıya gönderilecek bilgi SMSi'nin içeriğini belirtir. Türkçe karakter kullanılmamalıdır
RequestGsmOperator Int Daima '0' olarak gönderilmelidir.
RequestGsmType Int Daima '0' olarak gönderilmelidir.
Url String Web adresin URL bilgisini belirtir.
SuccessfulPageUrl String Başarılı ödeme işlemi sonrasında son kullanıcın yönlendirileceği üye işyerinin belirlediği URL bilgisine ait parametredir.
ErrorPageUrl String 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.
Country String Bu kısım daima boş olarak gönderilmelidir.
Currency String Bu kısım daima boş olarak gönderilmelidir.
Extra String Bu kısım daima boş olarak gönderilmelidir.
TurkcellServiceId String Servisinize ait NomuPay değeridir.NomuPay servisinizin değerini token bilgileri ile birlikte iletir.
-
MSaleProduct Bilgileri
Parametre Adı Veri Tipi Açıklama ProductId Int Daima '0' olarak iletilmelidir.
ProductCategory Int Sipariş ile ilgili ürünün/hizmetin kategorisini belirtir.
- ‘1’ Fiziksel Ürün
- ‘2’ Oyun
- ‘3’ Dijital İçerik
- ‘4’ Servis
- ‘5’ Sosyal Ağ/Arkadaşlık
- ‘6’ Aidat/Otomat
- ‘7’ Bahis
- ‘8’ Sigorta
- ‘10’ Kamu - Bilet - Fastfood
- ‘11’ Cep Sigorta
- ‘12’ Kutu Oyun
- ‘14’ Mobil Uygulama / Mobil Market
- ‘15’ Eğitim
- ‘16’ Bağış (sadece Turkcell aboneleri bağış ödemesi yapabilir)
- ‘19’ Sağlık
- ‘20’ White Label Adult
Sadece Turkcell aboneleri bağış servisini kullanabilir.ProductDescription String Tahsılatı yapılacak ürünün açıklamasına ait belirten parametredir.
Price Double Tahsil edilecek tutar belirtir.
Unit Int Daima '1' gönderilmelidir.
-
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
Servis Çıktı Parametreleri
-
Servis Çıktı Parametreleri
Parametre Adı Veri Tipi Açıklama RedirectUrl String Müşterinin yönlendirileceği NomuPay ortak ödeme sayfasının adresidir.
StatusCode Int ‘0’ değeri NomuPay Dinamik Ortak Ödeme Sayfası satış linki oluşturma bilgisinin alındığını belirtir. İşlem başlatılmış demektir.
‘1’ değeri NomuPay Dinamik Ortak Ödeme Sayfası satış linki oluşturma bilgisinin alınmadığını belirtir.İşlem başlatılamamış demektir.TicketObjectId String NomuPay Dinamik Ortak Ödeme Sayfası satış linkine ait değeri belirtir.
TransactionDate String Ödeme isteğinin tarihini belirtir.
Üye İşyeri Ödeme Sayfası Entegrasyonu
Üye işyeri NomuPay servisleri aracılığıyla ödeme sayfasını kullanarak ödeme hizmeti sunabilir.
Üye işyeri ödeme sayfanızın tasarımı size aittir.
NomuPay Ortak Ödeme Sayfası mobil ödeme entagrasyonu için Servis Girdi Parametreleri kısmında belirtilen parametreleri yayın adresinde ifade edilen Mobil Servis’e ait adrese iletmeniz gerekmektedir. SaleWithConfirm methodu kullanılmalıdır.
Servis Girdi Parametreleri & Örnek Servis Çağrı Kodları
-
Input Bilgileri
Parametre Adı Veri Tipi Açıklama Token Token Sınıfı Token Bilgileri parametreleri iç tabloda detaylandırılmıştır.
Gsm String Müşterinin telefon numarasını belirtir, 5111111111 formatında olmalıdır.
MPAY String Ü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.
Content String Tahsılatı yapılacak ürüne ait işlemin içeriğini belirten parametredir.
SendOrderResult bool İşlem Sonuç Servisi ile işlem sonuç bilgisi gönderim durumunu belirtir.
‘True’ bilgi gönderilsin
‘False’ bilgi gönderilmesinPaymentTypeId Int Ödeme yöntemi:
- ‘1’ Tek çekim
- ‘2’ Aylık abonelik
- ‘3’ Haftalık abonelik
- ‘4’ 2 haftalık abonelik
- ‘5’ 3 aylık abonelik
- ‘6’ 6 aylık abonelik
- ‘7’ aylık denemeli
- ‘8’ haftalık denemeli
- ‘9’ 2 haftalık denemeli
- ‘10’ 3 aylık denemeli
- ‘11’ 6 aylık denemeli
- ‘13’ 30 günlük
- ‘18’ Yıllık abonelik
ReceivedSMSObjectId Guid Daima ‘00000000-0000-0000-0000-000000000000’ olarak gönderilmelidir.
ProductList List ProductList şeklinde ifade edilen MSaleProduct elemanlarını temsil eder. Liste içerisinde tek bir adet MSaleProduct elemanı bulunmalıdır. MSaleProduct bilgileri parametreleri iç tabloda detaylandırılmıştır.
SendNotificationSMS bool Ödeme sonucunda son kullanıcıya gönderilecek bilgi SMS’ine ait seçimi belirtir.
- true: Bilgi gönderilsin
- false: Bilgi gönderilmesin
OnSuccessfulSMS String SendNotificationSMS parametresi "True" olarak ifade edilmiş ise, ödemenin başarılı olması durumunda kullanıcıya gönderilecek bilgi SMSi'nin içeriğini belirtir.
Türkçe karakter kullanılmamalıdırOnErrorSMS String SendNotificationSMS parametresi "True" olarak ifade edilmiş ise, ödemenin başarısız olması durumunda kullanıcıya gönderilecek bilgi SMSi'nin içeriğini belirtir.
Türkçe karakter kullanılmamalıdırRequestGsmOperator Int Daima '0' olarak gönderilmelidir.
RequestGsmType Int Daima '0' olarak gönderilmelidir.
Url String Web adresin URL bilgisini belirtir.
CustomerIpAddress String Ödeme işlemini gerçekleştiren son kullanıcıya ait IP adresi bilgisini belirtir.
Extra String Bu kısım daima boş olarak gönderilmelidir.
TurkcellServiceId String Servisinize ait NomuPay değeridir.NomuPay servisinizin değerini token bilgileri ile birlikte iletir.
-
MSaleProduct Bilgileri
Parametre Adı Veri Tipi Açıklama ProductId Int Daima ‘0’ olarak iletilmelidir.
ProductCategory Int Sipariş ile ilgili ürünün/hizmetin kategorisini belirtir.
- ‘1’ Fiziksel Ürün
- ‘2’ Oyun
- ‘3’ Dijital İçerik
- ‘4’ Servis
- ‘5’ Sosyal Ağ/Arkadaşlık
- ‘6’ Aidat/Otomat
- ‘7’ Bahis
- ‘8’ Sigorta
- ‘10’ Kamu - Bilet - Fastfood
- ‘11’ Cep Sigorta
- ‘12’ Kutu Oyun
- ‘14’ Mobil Uygulama / Mobil Market
- ‘15’ Eğitim
- ‘16’ Bağış (sadece Turkcell aboneleri bağış ödemesi yapabilir)
- ‘19’ Sağlık
- ‘20’ White Label Adult
Sadece Turkcell aboneleri bağış servisini kullanabilir.ProductDescription String Tahsılatı yapılacak ürünün açıklamasına ait belirten parametredir.
Price Double Tahsil edilecek tutar belirtir.
Unit Int Daima '1' gönderilmelidir.
-
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
Servis Çıktı Parametreleri
-
Servis Çıktı Parametreleri
Parametre Adı Veri Tipi Açıklama PaymentCategoryId Int Daima ‘0’ olarak ifade edilecektir.
LastTransactionDate DateTime İşlemin tarihini belirtir.
MPAY String Üye işyerinin ödeme isteğinde belirttiği MPAY değeridir.
SubscriberId Guid Abonelik kurgusu bulunuyor ise Nomupay tarafından benzersiz değer elde edilir.
MicroPaymentResults List MicroPaymentResults Bilgileri parametreleri iç tabloda detaylandırılmıştır.
-
MicroPaymentOutput Bilgileri
Parametre Adı Veri Tipi Açıklama StatusCode Int Ödeme işlemi başlatılabilme
0: Başarılı
1: BaşarısızErrorCode String Onay Sms’inin iletildiğini belirten hata kodu.SMS iletilmiş ise M121005 ifade edilir.
ErrorMessage String Onay Sms’inin iletildiğini belirten hata mesajı. SMS iletilmiş ise Istek kaydedildi ifade edilir.
Marka Standartları
SMS Keyword Entegrasyonu
Bu kurguda ürün satışı bir web sitesi üzerinden yapılmaz. Üye işyeri tarafından NomuPay sisteminde bir ürün oluşturulur ve ürünle ilişkilendirilmiş bir keyword tanımlanır. Üye işyeri bu keyword'ü muhtelif bilgilendirme kanallarıyla müşteriye iletir (web sitesi, gazete ilanı, broşür, vs). Müşteri'nin bu keyword'ü SMS ile 7979’a göndermesiyle işlem başlar ve satış gerçekleşir.
Örnek: “SATINAL” -> 7979
İş akışınızın kurgusu gereği SMS keyword entegrasyonu sonrası müşterilerinize pin gönderimi sağlayabilirsiniz.Pinler, bir ürün veya hizmetin müşteri tarafından alınmasını sağlayacak tek kullanımlık şifrelerdir.Başarılı ödeme sonrasında müşteriye 7979’dan üye işyerinin üründe belirlediği pin değeri gönderilir.
Örnek: “SATINAL” -> 7979
7979 -> Kullanmanız gereken pin “A134nf6”