Payment Service
Başlarken
PanelKeşfet API
REX API
Ödeme Yönetimi
Payment Service
Ödeme istekleri “Payment Service” aracılığı ile başlatılır. Servisler isteklerini KONG üzerinden “Payment Service”‘e iletirler.
Servisler ödeme isteği yapmak istediğinde aşağıdaki formatta isteği göndermelidir.
- Content-type olarak application/json,
- kimlik doğrulama için HTTP Basic Authentication kullanılır.
- 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’
POSThttps://apigw.tvoip.turkcell.com.tr/pgw/paymentService
{
"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"
}
| property | type | desciption |
| *transactionId | String | isteğe ait unique bir değer verilmeli |
| *msisdn | String | Ücretlendirilecek kullanıcının GSM numarası |
| *channelId | String | Ücretlendirme kanal id değeri (bkz. Ödeme Genel)
|
| *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.) |
{
"resultCode": 1103,
"resultDesc": "CONSENT_REQUESTED",
"transactionId": "6666466"
}
| property | type | desciption |
| *resultCode | int | Dönüş kodu id değeri |
| *resultDesc | String | Dönüş açıklaması |
| *transactionId | String | İsteğe ait id değeri |
