Odeme Servisi
Ödeme istekleri “Payment Service” aracılığı ile başlatılır. Servisler isteklerini KONG üzerinden “Payment Service”‘e iletirler.
- Content-type olarak application/json,
- kimlik doğrulama için HTTP Basic Authentication kullanılır.
Ödeme isteğindeki tüm alanlar tüm ödeme kanalları için ortaktır. Ödeme kanalına göre değişen alanlar şu şekildedir:
- channelId : Ödeme tipine göre aşağıdaki kanallar gönderilmelidir.- Faturaya rezervli yansıtılmak isteniyorsa channelId:10 (reserve&commit)- Faturaya direkt yansıtılmak isteniyorsa channnelId:11 (direct debit)- Kredi kartı ile ödeme yapılmak isteniyorsa channelId:40- Uygulama içi satın alma ile ödeme yapılmak isteniyorsa channelId:50
- isDeliverable : Sipariş özelinde servisler ürünlerin teslimatını istiyorsa bu parametre “true” gönderilmelidir. Böylelikle teslimat adresi oluşturulması istenir.Payment sistemleri üzerinde bu alan kanal özelinde default değerlere sahiptir. Fakat servis istek içerisinde bu değeri “true” ya da “false” ne gönderir ise o işleme alınır.Kanalların payment sistemlerinde tanımlanmış olan default değerleri şu şekildedir:- Reserve&Commit(channelId:10) ödeme yöntemi için isDelivarable parametresinin default değeri ‘false’- Direct Debit(channnelId:11) ödeme yöntemi için isDelivarable parametresinin default değeri ‘false’- Kredi kartı(channelId:40) ödeme yöntemi için isDelivarable parametresinin default değeri ‘true’- Uygulama içi satın alma(channelId:50) ödeme yöntemi için isDelivarable parametresinin default değeri ‘false’
- isBillingRequired : Sipariş özelinde servisler satın alınan ürünlerin faturasının iletilmeisni istiyorsa bu parametre “true” gönderilmelidir. Böylelikle E-Billing adresi ya da fatura adresi oluşturulması gerekir.Payment sistemleri üzerinde bu alan kanal özelinde default değerlere sahiptir. Fakat servis istek içerisinde bu değeri “true” ya da “false” gönderir ise o işleme alınır.Kanalların payment sistemlerinde tanımlanmış olan default değerleri şu şekildedir:- Reserve&Commit(channelId:10) ödeme yöntemi için isDelivarable parametresinin default değeri ‘false’- Direct Debit(channnelId:11) ödeme yöntemi için isDelivarable parametresinin default değeri ‘false’- Kredi kartı(channelId:40) ödeme yöntemi için isDelivarable parametresinin default değeri ‘true’- Uygulama içi satın alma(channelId:50) ödeme yöntemi için isDelivarable parametresinin default değeri ‘false’
- isRemovable : Ürün özelinde servisler ürünlerin sepet içerisinden kaldırılmasına izin vermek istiyorsa bu parametre “true” gönderilmelidir.Kanalların payment sistemlerinde tanımlanmış olan default değerleri şu şekildedir:- Reserve&Commit(channelId:10) ödeme yöntemi için isDelivarable parametresinin default değeri ‘true’- Direct Debit(channnelId:11) ödeme yöntemi için isDelivarable parametresinin default değeri ‘true’- Kredi kartı(channelId:40) ödeme yöntemi için isDelivarable parametresinin default değeri ‘true’- Uygulama içi satın alma(channelId:50) ödeme yöntemi için isDelivarable parametresinin default değeri ‘true’
Servisler ödeme isteği yapmak istediğinde aşağıdaki formatta isteği göndermelidir.
https://apigw.tvoip.turkcell.com.tr/pgw/paymentService
İstek
{
"additionalParameters": [],
"channelId": 40,
"itemList": [
{
"count": 1,
"id": 50,
"isRemovable": true
},
{
"count": 3,
"id": 53,
"isRemovable": false
}
],
"language": "tr",
"msisdn": "9053XXXXXXXX",
"paymentMethod": "reserve",
"isDeliverable": true,
"isBillingRequired": false,
"transactionId": "66664"
}
Açıklama
| Özellik | Tip | Açıklama |
|---|
| transactionId | String | İsteğe ait unique bir değer verilmeli |
| msisdn | String | Ücretlendirilecek kullanıcının GSM numarası |
| channelId | | Ücretlendirme kanal id değeri (bkz. Ödeme Genel) |
| channelId | | Faturaya direkt yansıtılacak ödemelerde: 11, (Direct Debit) |
| channelId | String | Faturaya direkt yansıtılacak ödemelerde: 11, (Direct Debit) |
| channelId | | Kredi kartının dahil olduğu ödemelerde: 40, |
| channelId | | Uygulama içi satın almalarda: 50 |
| paymentMethod | String | ‘reserve’ statik olarak kullanılır |
| isDeliverable | Boolean | Teslimatlı olan siparişler için ‘true’ kullanılır. Sipariş özelinde bir parametredir. |
| isBillingRequired | Boolean | Fatura istenen siparişler için ‘true’ kullanılır. Sipariş özelinde bir parametredir. |
| isRemovable | Boolean | Sepetten silinmesi istenmeyen ürünler için’false’ kullanılır.Ürün özelinde bir parametredir. |
| itemList | json List | Satışı yapılacak ürün bilgileri.(Uygulama içi satın alma kurgularında itemList tek bir eleman alabilir.) |
İstek
{
"resultCode": 1103,
"resultDesc": "CONSENT_REQUESTED",
"transactionId": "6666466"
}
Açıklama
| Özellik | Tip | Açıklama |
|---|
| resultCode | int | Dönüş kodu id değeri |
| resultDesc | String | Dönüş açıklaması |
| transactionId | String | İsteğe ait id değeri |