Başlarken

Ödeme Yönetimi

Ödeme alt yapısı için kullanılan Payment API, servis uygulamalarının kullanıcıları ücretlendirebilmesini sağlar. Ücretlendirme tüm kullanıcılar için kredi kartı ve uygulama içi satın alma alt yapısı ile sağlanırken, Turkcell kullanıcıları için ek olarak faturasına yansıtma ile gerçekleşebilir.

Servis uygulamasının, satış yapacağı ürünlerin ödeme yöntemini doğru belirlemesi önemlidir. Eğer ürünler fiziksel ise(tangible) kredi kartı, dijital ise uygulama içi satın alma, data ise faturaya yansıtma ödeme şekli seçilerek kurgu sağlanmalıdır. Uygulama içi satın alma ile fiziksel ürünlerin satışı asla sağlanamaz mutlaka dijital ürünler olmalıdır./p>

Servis uygulaması kullanıcılarını kredi kartı üzerinden ücretlendirmek istiyorsa, kullanıcısından satın alınmak istenen ürünleri mesajlaşma yoluyla alır ve sipariş detayı ile Payment API’yi çağırır. Payment API sipariş detayını kullanıcıya gösterir, ödeme yöntemini ve adres bilgilerini sorar, siparişini tamamlaması için 3D secure ile kart doğrulaması yapar. Ödeme tamamlandığında servis uygulaması asenkron bilgilendirilir.

Servis uygulaması ürünlerini uygulama içi satın alma alt yapısı ile kullanıcılara sunmak istiyorsa, satın alınmak istenen ürünler servis kurgusu gereği mesajlaşma yolu ile alınır. Kullanıcıdan onay alındıktan sonra Payment API store’lara(AppStore ve GooglePlay) yönlendirir. Satın alma başarılı bir şekilde gerçekleştikten sonra servis uygulaması API tarafından asenkron bilgilendirilir.

1. Ön Tanımlar

Servis uygulamalarının ücretlendirmeyi doğru şekilde yapabilmesi için bazı ön tanımlar gereklidir. Öncelikle satışı yapacak servis sahibinin firma bilgilerinin tanımlamaları yapılmalıdır. Daha sonra servis özelinde ürün tanımları tamamlanmalıdır. Eğer kredi kartı ile bir satış sağlanacaksa bir servis içerisinde birden fazla ürünün satışı gerçekleşebilir. Fakat uygulama içi satın alma ile ödeme işlemi gerçekleştirilmek isteniyorsa bir servis içerisinde şimdilik sadece bir ürün satışı gerçekleşebilir.

Firma Bilgileri Tanımı

Satışı yapacak olan servis sahibi firmanın adı, adresi ve iletişim bilgileri

Ücretlendirme Kanal Tanımı

‘Payment Service’ isteği yaparken hangi ödeme kanalı kullanılacaksa uygun kanal bilgisi gönderilmesi mutlaka gereklidir. Bir servisin ödeme isteği hangi kanal ile ödeme işlemi yapılacak olursa olsun tamamen aynıdır, değişmesi gereken tek alan ise kanal bilgisi alanıdır.

Faturaya rezervli yansıtma kanal yetkisi (Reserve&Commit:10)

Faturaya direkt yansıtma kanal yetkisi (Direct Debit:11)

Kredi kartına yansıtma kanalı yetkisi (Credit Card:40)

Uygulama içi satın alma kanalı yetkisi (InApp Purchase:50)

Ürün Katalog Tanımı

Satışı yapılacak ürünlere ait fiyat, para birimi, logo url bilgisi ve ürün tipi bilgisi(dijital veya fiziksel)

Listener Service için URL Tanımı

Payment Service dönüşleri servis uygulamasının callback URL’ine asenkron iletilir

2. Erişim ve Kısıtlar

Webservice isteklerinin içeriği JSON formatında taşınmaktadır. İstekler HTTPS protokolü ile yapılır ve kullanıcı doğrulaması için HTTP Basic Authentication yöntemi kullanılır.Servis uygulamaları Basic Authentication için daha önceden TES için sağlanan kullanıcı adı/şifre bilgisini kullanmalıdır.

3. Ortam Bilgisi

Sunucu	Ortam	URL
PAYMENT	Canlı	https://apigw.tvoip.turkcell.com.tr/pgw
PAYMENT	Test	https://prpapigw.tvoip.turkcell.com.tr/ppgw

Ödeme Genel