-
Tami Sanal POS
Tami Sanal POS
Puanlı Satış Genel Açıklama
Tami üzerinden yapılan tek çekimli veya taksitli satış işlemi iletilirken kullanılmak istenen puan bilgisi de gönderilir. Puan sorgulama cevabında dönen puan tipi ve kullanılmak istenen puan tutarı satış işleminin isteğinde gönderilir.
Satış isteğinde amount alanında toplam işlem tutarı gönderilir. Gönderilen tutarın ne kadarının puandan kullanılması istendiğini rewardToBeUserd alanın altındaki amount tutarında göndermeniz gerekir.
Test/Prod Ortamları API Kullanıcı Bilgisi
Tami üzerinden gerçekleştirilen Sanal POS işlemleri için üye işyerleri test ortamında gerçekleştirmek istedikleri kontrolleri aşağıdaki tabloda verilen üye işyeri bilgilerini kullanabilirler.
Üretim ortamında Tami üzerinden gerçekleştirilecek Sanal POS işlemleri için başvuru yapılarak üye işyeri numarası alınır ve bu bilgilerle işlem geçirilir.
Sandbox test portaline https://sandbox-portal.tami.com.tr adresinden ulaşabilirsin. Aşağıda iletilen kullanıcılar ile test portale giriş yapıldığında bu kullanıcıya bağlı işyeri tarafından gerçekleştirilen işlemleri görüntülenebilir. İşlemler iptal/iade edilebilir.
| Kullanıcı Telefon Numarası | Kullanıcı Şifre | Sms / Email Otp | İşyeri Numarası | Terminal Numarası | Secret Key |
|---|---|---|---|---|---|
| 5346484700 | 147855 | 147852 | 77006950 | 84006953 | 0edad05a-7ea7-40f1-a80c-d600121ca51b |
| 5346484709 | 147851 | 147852 | 77006951 | 84006954 | c8581bb6-a4b2-4925-8c94-529fc651399e |
| 5346484803 | 147856 | 147852 | 77006952 | 84006955 | ff7d4895-0c32-4f48-86ab-fb9ecca9f3d7 |
| 5346484807 | 147850 | 147852 | 77006953 | 84006956 | 33124ff0-0b19-4cf9-b002-13a35eae865b |
| 5346484800 | 147851 | 147852 | 77006954 | 84006957 | 7daf9631-e136-4164-9ddb-dd1c02df851d |
| 5346484808 | 147854 | 147852 | 77006956 | 84006959 | fe6f3fff-0434-4932-a27d-bb3dac9de49d |
Hash Hesaplama
Bir çok işlem tipi için gönderilen isteğin header bilgisine PG-Auth-Token eklenmelidir. PG-Auth-Token değeri “MerchantNumber:TerminalNumber:Hash” değerlerinden oluşur.
Burada hash hesabı yapılırken üye işyerine ait merchantNumber, terminalNumber ve secretKey bilgileri sha256 ile hashleyip stringe çevrilerek elde edilir.
public class SHA256Example {
public static String sha256(Long merchantNumber, Long terminalNumber, String secretKey) {
String text = merchantNumber.toString() + terminalNumber.toString() + secretKey;
try {
MessageDigest digest = MessageDigest.getInstance("SHA-256");
byte[] hash = digest.digest(text.getBytes(StandardCharsets.UTF_8));
String sha256Hex = DatatypeConverter.printBase64Binary(hash);
return sha256Hex;
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
return null;
}
}
}
TAMİ Test Portalı Bilgileri
Tami test portalına https://sandbox-portal.tami.com.tr adresinden erişebilirsiniz. Bu adresten yukarıda iletilen kullanıcılar ile portal ekranını görüntüleyebilirsin.
Üretim ortamı bilgileriniz için https://portal.tami.com.tr adresinden üye olabilir veya e-ticaret destek birimine başvurabilirsin.
Satış İşlemi API Bilgileri
Test ortamında yapılacak çalışmalarda "https://sandbox-paymentapi.tami.com.tr/payment/auth" url'i kullanılacaktır.
Üretim ortamında yapılacak çalışmalarda ise "https://paymentapi.tami.com.tr/payment/auth" url'i kullanılacaktır.
İstek Parametreleri ve Açıklamaları
| Parametre Adı | Format | Uzunluk | (O)psiyonel / (Z)orunlu/ (Ş)artlı | Açıklama |
|---|---|---|---|---|
| orderId | String | (2-36) | Z | Ödeme isteğinin Tami-müşteri arasındaki iletişiminde kullanılan tekil bir iletişim bilgisidir. Üye işyeri ve pos çifti için bu değer tekil olmalıdır. OrderId alanı, alfanümerik karakterler ile yalnızca '-' ve '_' karakterlerini içerebilir. Ancak, '-' ve '_' karakterlerini art arda içermemelidir. |
| amount | Decimal | Z | İşlem tutarıdır. Küsurat ayracı nokta (.) ile yapılmalıdır. | |
| rewardToBeUsed altındaki (type) | Char | Z | Kullanımak istenen Puan tipidir. Alabileceği değerler (BNS, TotalPoint, Chippara, ParaPuan, KullanPuan) | |
| rewardToBeUsed altındaki (amount) | Decimal | Z | Kullanılmak istenen Puan tutarıdır. Küsurat ayracı nokta (.) ile yapılmalıdır. | |
| currency | String | 3 | Z | İşlemin döviz kodunu belirtir. Örnek: TL için TRY gönderilmeli. |
| paymentGroup | String | Z | Ödeme grubu, varsayılan PRODUCT. | |
| paymentChannel | enum | Ödeme kanalı. Geçerli değerler enum içinde sunulmaktadır: WEB, MOBILE, MOBILE_WEB, MOBILE_IOS, MOBILE_ANDROID, MOBILE_WINDOWS, MOBILE_TABLET, MOBILE_PHONE | ||
| card | Object | Z | ||
| cvv | String | Z | Ödemenin alınacağı kartın güvenlik kodu bilgisi. | |
| expireMonth | Number | (1-12) | Z | Ödemenin alınacağı kartın son kullanma tarihi ay bilgisi. |
| expireYear | Number | 4 | Z | Ödemenin alınacağı kartın son kullanma tarihi yıl bilgisi. |
| holderName | String | 30 | Z | Ödemenin alınacağı kart sahibinin adı soyadı bilgisi. |
| number | String | (5-35) | Z | Ödemenin alınacağı kart numarası bilgisi. |
| billingAddress | Object | O | ||
| address | String | 400 | O | Üye işyeri tarafındaki fatura adresi bilgisi. |
| emailAddress | String | O | Üye işyerine ait mail bilgisi | |
| city | String | 30 | O | Üye işyeri tarafındaki fatura adresi şehir bilgisi. |
| companyName | String | 100 | O | Üye işyerinin ticari unvan bilgisi. |
| country | String | 50 | O | Üye işyeri tarafındaki fatura adresi ülke bilgisi. |
| contactName | String | 30 | O | Üye işyeri tarafındaki fatura adresi, ad soyad bilgisi. |
| phone | String | O | Üye işyeri tarafındaki alıcıya ait GSM numarası. | |
| zipCode | String | 15 | O | Üye işyeri tarafındaki fatura adresi posta kodu. |
| district | String | 50 | O | Üye işyeri tarafındaki fatura adresi semt bilgisi. |
| shippingAddress | Object | O | ||
| address | String | 400 | O | Üye işyeri tarafındaki teslimat adresi bilgisi. |
| emailAddress | String | O | Üye işyerine ait mail bilgisi | |
| city | String | 30 | O | Üye işyeri tarafındaki teslimat adresi şehir bilgisi. |
| country | String | 50 | O | Üye işyeri tarafındaki teslimat adresi ülke bilgisi. |
| contactName | String | 30 | O | Üye işyeri tarafındaki teslimat adresi, ad soyad bilgisi. |
| zipCode | String | 15 | O | Üye işyeri tarafındaki teslimat adresi posta kodu bilgisi. |
| district | String | 50 | O | Üye işyeri tarafındaki teslimat adresi semt bilgisi. |
| buyer | Object | Z | ||
| ipAddress | String | Z | Üye işyeri tarafındaki alıcıya ait ip adresidir. Alıcının gerçek ip adresi iletilmesi gerekmektedir. | |
| buyerId | String | 50 | Ş | E-posta adresi alıcıya ait geçerli ve erişilebilir bir adres olmalıdır. |
| name | String | Ş | Üye işyeri tarafındaki alıcıya ait ad. Buyer objesi opsiyonel bir alandır fakat buyer objesinden herhangi bir alan gönderilse name iletilmesi zorunlu olur. | |
| surName | String | Ş | Üye işyeri tarafındaki alıcıya ait soyad. Buyer objesi opsiyonel bir alandır fakat buyer objesinden herhangi bir alan gönderilse surname iletilmesi zorunlu olur. | |
| identityNumber | String | O | Üye işyeri tarafındaki alıcıya ait kimlik (TCKN) numarası. | |
| city | String | O | Üye işyeri tarafındaki alıcıya ait şehir bilgisi. | |
| country | String | O | Üye işyeri tarafındaki alıcıya ait ülke bilgisi. | |
| emailAddress | String | Z | Üye işyeri tarafındaki alıcıya ait e-posta bilgisi. E-posta adresi alıcıya ait geçerli ve erişilebilir bir adres olmalıdır. | |
| phoneNumber | String | Z | Üye işyeri tarafındaki alıcıya ait GSM numarasıdır. | |
| registrationAddress | String | O | Üye işyeri tarafındaki alıcıya ait kayıt adresi. | |
| zipCode | String | O | Üye işyeri tarafındaki alıcıya ait posta kodu. | |
| registrationDate | O | Üye işyeri tarafındaki alıcıya ait kayıt tarihi. Tarih formatı 2015-09- 17 23:45:06 şeklinde olmalıdır. | ||
| lastLoginDate | O | Üye işyeri tarafındaki alıcıya ait son giriş tarihi. Tarih formatı 2015- 09-17 23:45:06 şeklinde olmalıdır. | ||
| basket | O | |||
| basketId | String | Ş | Üye işyeri tarafındaki sepete ait id. Basket içerisinde item iletilirse basketId gönderilmesi zorunlu olur. | |
| basket/basketItems | List | |||
| itemId | String | Ş | Üye işyeri tarafındaki sepetteki ürüne ait id. Basket içerisinde item iletilirse itemId gönderilmesi zorunlu olur. | |
| itemType | String | Ş | Üye işyeri tarafındaki sepetteki ürüne ait tip. Geçerli enum değerler: PHYSICAL ve VIRTUAL. Basket içerisinde item iletilirse itemType gönderilmesi zorunlu olur. | |
| name | String | Ş | Üye işyeri tarafındaki sepetteki ürüne ait ismi. Basket içerisinde item iletilirse name gönderilmesi zorunlu olur. | |
| category | String | O | Üye işyeri tarafındaki sepetteki ürüne ait kategori . | |
| subCategory | String | O | Üye işyeri tarafındaki sepetteki ürüne ait alt kategori. | |
| unitPrice | Decimal | min 0.0 | O | Üye işyeri tarafındaki sepetteki ürünün tekil tutarıdır. |
| totalPrice | Decimal | min 0.0 | Ş | Üye işyeri tarafındaki sepetteki ürüne ait toplam tutar. 0 ve 0’dan küçük olamaz, tutarlar toplamı sepet tutarına (amount) eşit olmalıdır. Unitprice * numberOfProducts = totalPrice olmalı Basket içerisinde item iletilirse totalPrice gönderilmesi zorunlu olur. |
| numberOfProducts | Number | 1-99999 | O | Üye işyeri tarafındaki sepetteki ürünün adedidir. |
| securityHash | String | Z | Dokümanda belirtilen şekilde hesaplanıp iletilmesi beklenen değerdir. Eksik veya hatalı ise işlem bankaya yönlendirilmez, hata verilir. |
Garanti BBVA API İstek Örneği
{
"amount": 20,
"orderId": "7707670050778",
"currency": "TRY",
"installmentCount": 1,
"card": {
"holderName": "Ad Soyad",
"cvv": "",
"expireMonth": 12,
"expireYear": 2026,
"number": "5406675406675403"
},
"isRewardToBeUsed": true,
"rewardToBeUsed": {
"list": [
{
"type": "BNS",
"amount": 20
}
]
},
"billingAddress": {
"emailAddress": "esrasevinc@gmail.com",
"address": "Ä°nÅŸirah sok. No:70 Etiler/BeÅŸiktaÅŸ",
"city": "Ä°stanbul",
"companyName": "Yılmazlar A.Ş",
"country": "Türkiye",
"district": "Bebek Mah.",
"contactName": "Esra Sevinç",
"phoneNumber": "05364604016",
"zipCode": "343400"
},
"shippingAddress": {
"emailAddress": "yilmaz@gmail.com",
"address": "Levent Mah. Nispetiye Cad. No:8 BeÅŸiktaÅŸ",
"city": "Ä°stanbul",
"companyName": "Yılmazlar Şirketi",
"country": "Türkiye",
"district": "Levent",
"contactName": "Nilüfer",
"phoneNumber": "05346484777",
"zipCode": "3434221"
},
"buyer": {
"ipAddress": "192.168.1.70",
"buyerId": "678654",
"name": "YeÅŸim",
"surName": "Çınar",
"identityNumber": 28629160374,
"city": "Ä°stanbul",
"country": "Türkiye",
"zipCode": "348222",
"emailAddress": "yesim.cinar@gmail.com",
"phoneNumber": "0536460996",
"registrationAddress": "Ortaköy Mah. Ulus Sok. Beşiktaş",
"lastLoginDate": "2022-11-05T13:39:11.332",
"registrationDate": "2022-10-11T12:59:11.332"
},
"basket": {
"basketId": "736735353u3ye",
"basketItems": [
{
"itemId": "786543r453",
"name": "Lego Duplo",
"itemType": "PHYSICAL",
"category": "oyuncak",
"subCategory": "alt oyuncak",
"numberOfProducts": 1,
"totalPrice": 20,
"unitPrice": 1
}
]
},
"paymentGroup": "PRODUCT",
"securityHashâ€: “84839djf93klw00llr=="
}
Halkbank API İstek Örneği
{
"amount": 20,
"orderId": "7707670050778",
"currency": "TRY",
"installmentCount": 1,
"card": {
"holderName": "Ad Soyad",
"cvv": "",
"expireMonth": 12,
"expireYear": 2026,
"number": "9792100000000001"
},
"isRewardToBeUsed": true,
"rewardToBeUsed": {
"list": [
{
"type": "PARTIALPOINTS",
"amount": 20
}
]
},
"billingAddress": {
"emailAddress": "esrasevinc@gmail.com",
"address": "Ä°nÅŸirah sok. No:70 Etiler/BeÅŸiktaÅŸ",
"city": "Ä°stanbul",
"companyName": "Yılmazlar A.Ş",
"country": "Türkiye",
"district": "Bebek Mah.",
"contactName": "Esra Sevinç",
"phoneNumber": "05364604016",
"zipCode": "343400"
},
"shippingAddress": {
"emailAddress": "yilmaz@gmail.com",
"address": "Levent Mah. Nispetiye Cad. No:8 BeÅŸiktaÅŸ",
"city": "Ä°stanbul",
"companyName": "Yılmazlar Şirketi",
"country": "Türkiye",
"district": "Levent",
"contactName": "Nilüfer",
"phoneNumber": "05346484777",
"zipCode": "3434221"
},
"buyer": {
"ipAddress": "192.168.1.70",
"buyerId": "678654",
"name": "YeÅŸim",
"surName": "Çınar",
"identityNumber": 28629160374,
"city": "Ä°stanbul",
"country": "Türkiye",
"zipCode": "348222",
"emailAddress": "yesim.cinar@gmail.com",
"phoneNumber": "0536460996",
"registrationAddress": "Ortaköy Mah. Ulus Sok. Beşiktaş",
"lastLoginDate": "2022-11-05T13:39:11.332",
"registrationDate": "2022-10-11T12:59:11.332"
},
"basket": {
"basketId": "736735353u3ye",
"basketItems": [
{
"itemId": "786543r453",
"name": "Lego Duplo",
"itemType": "PHYSICAL",
"category": "oyuncak",
"subCategory": "alt oyuncak",
"numberOfProducts": 1,
"totalPrice": 20,
"unitPrice": 1
}
]
},
"paymentGroup": "PRODUCT",
"securityHashâ€: “84839djf93klw00llr=="
}
İş Bankası API İstek Örneği
{
"amount": 20,
"orderId": "7707670050778",
"currency": "TRY",
"installmentCount": 1,
"card": {
"holderName": "Ad Soyad",
"cvv": "",
"expireMonth": 12,
"expireYear": 2026,
"number": "4508034508034509"
},
"isRewardToBeUsed": true,
"rewardToBeUsed": {
"list": [
{
"type": "MAXIPUAN",
"amount": 20
}
]
},
"billingAddress": {
"emailAddress": "esrasevinc@gmail.com",
"address": "İnşirah sok. No:70 Etiler/Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar A.Ş",
"country": "Türkiye",
"district": "Bebek Mah.",
"contactName": "Esra Sevinç",
"phoneNumber": "05364604016",
"zipCode": "343400"
},
"shippingAddress": {
"emailAddress": "yilmaz@gmail.com",
"address": "Levent Mah. Nispetiye Cad. No:8 Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar Şirketi",
"country": "Türkiye",
"district": "Levent",
"contactName": "Nilüfer",
"phoneNumber": "05346484777",
"zipCode": "3434221"
},
"buyer": {
"ipAddress": "192.168.1.70",
"buyerId": "678654",
"name": "Yeşim",
"surName": "Çınar",
"identityNumber": 28629160374,
"city": "İstanbul",
"country": "Türkiye",
"zipCode": "348222",
"emailAddress": "yesim.cinar@gmail.com",
"phoneNumber": "0536460996",
"registrationAddress": "Ortaköy Mah. Ulus Sok. Beşiktaş",
"lastLoginDate": "2022-11-05T13:39:11.332",
"registrationDate": "2022-10-11T12:59:11.332"
},
"basket": {
"basketId": "736735353u3ye",
"basketItems": [
{
"itemId": "786543r453",
"name": "Lego Duplo",
"itemType": "PHYSICAL",
"category": "oyuncak",
"subCategory": "alt oyuncak",
"numberOfProducts": 1,
"totalPrice": 20,
"unitPrice": 1
}
]
},
"paymentGroup": "PRODUCT",
"securityHash”: “84839djf93klw00llr=="
}
Vakıfbank API İstek Örneği
{
"amount": 20,
"orderId": "7707670050778",
"currency": "TRY",
"installmentCount": 1,
"card": {
"holderName": "Ad Soyad",
"cvv": "691",
"expireMonth": 12,
"expireYear": 2029,
"number": "5521010140829928"
},
"isRewardToBeUsed": true,
"rewardToBeUsed": {
"list": [
{
"type": "TotalPoint",
"amount": 20
}
]
},
"billingAddress": {
"emailAddress": "esrasevinc@gmail.com",
"address": "İnşirah sok. No:70 Etiler/Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar A.Ş",
"country": "Türkiye",
"district": "Bebek Mah.",
"contactName": "Esra Sevinç",
"phoneNumber": "05364604016",
"zipCode": "343400"
},
"shippingAddress": {
"emailAddress": "yilmaz@gmail.com",
"address": "Levent Mah. Nispetiye Cad. No:8 Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar Şirketi",
"country": "Türkiye",
"district": "Levent",
"contactName": "Nilüfer",
"phoneNumber": "05346484777",
"zipCode": "3434221"
},
"buyer": {
"ipAddress": "192.168.1.70",
"buyerId": "678654",
"name": "Yeşim",
"surName": "Çınar",
"identityNumber": 28629160374,
"city": "İstanbul",
"country": "Türkiye",
"zipCode": "348222",
"emailAddress": "yesim.cinar@gmail.com",
"phoneNumber": "0536460996",
"registrationAddress": "Ortaköy Mah. Ulus Sok. Beşiktaş",
"lastLoginDate": "2022-11-05T13:39:11.332",
"registrationDate": "2022-10-11T12:59:11.332"
},
"basket": {
"basketId": "736735353u3ye",
"basketItems": [
{
"itemId": "786543r453",
"name": "Lego Duplo",
"itemType": "PHYSICAL",
"category": "oyuncak",
"subCategory": "alt oyuncak",
"numberOfProducts": 1,
"totalPrice": 20,
"unitPrice": 1
}
]
},
"paymentGroup": "PRODUCT",
"securityHash”: “84839djf93klw00llr=="
}
QNB API İstek Örneği
{
"amount": 20,
"orderId": "7707670050778",
"currency": "TRY",
"installmentCount": 1,
"card": {
"holderName": "Ad Soyad",
"cvv": "",
"expireMonth": 1,
"expireYear": 2050,
"number": "4155650100416111"
},
"isRewardToBeUsed": true,
"rewardToBeUsed": {
"list": [
{
"type": "ParaPuan",
"amount": 20
}
]
},
"billingAddress": {
"emailAddress": "esrasevinc@gmail.com",
"address": "İnşirah sok. No:70 Etiler/Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar A.Ş",
"country": "Türkiye",
"district": "Bebek Mah.",
"contactName": "Esra Sevinç",
"phoneNumber": "05364604016",
"zipCode": "343400"
},
"shippingAddress": {
"emailAddress": "yilmaz@gmail.com",
"address": "Levent Mah. Nispetiye Cad. No:8 Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar Şirketi",
"country": "Türkiye",
"district": "Levent",
"contactName": "Nilüfer",
"phoneNumber": "05346484777",
"zipCode": "3434221"
},
"buyer": {
"ipAddress": "192.168.1.70",
"buyerId": "678654",
"name": "Yeşim",
"surName": "Çınar",
"identityNumber": 28629160374,
"city": "İstanbul",
"country": "Türkiye",
"zipCode": "348222",
"emailAddress": "yesim.cinar@gmail.com",
"phoneNumber": "0536460996",
"registrationAddress": "Ortaköy Mah. Ulus Sok. Beşiktaş",
"lastLoginDate": "2022-11-05T13:39:11.332",
"registrationDate": "2022-10-11T12:59:11.332"
},
"basket": {
"basketId": "736735353u3ye",
"basketItems": [
{
"itemId": "786543r453",
"name": "Lego Duplo",
"itemType": "PHYSICAL",
"category": "oyuncak",
"subCategory": "alt oyuncak",
"numberOfProducts": 1,
"totalPrice": 20,
"unitPrice": 1
}
]
},
"paymentGroup": "PRODUCT",
"securityHash”: “84839djf93klw00llr=="
}
Akbank API İstek Örneği
{
"amount": 20,
"orderId": "7707670050778",
"currency": "TRY",
"installmentCount": 1,
"card": {
"holderName": "Ad Soyad",
"cvv": "000",
"expireMonth": 1,
"expireYear": 2035,
"number": "5571136000700047"
},
"isRewardToBeUsed": true,
"rewardToBeUsed": {
"list": [
{
"type": "CCBCHIPPARA",
"amount": 20
}
]
},
"billingAddress": {
"emailAddress": "esrasevinc@gmail.com",
"address": "İnşirah sok. No:70 Etiler/Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar A.Ş",
"country": "Türkiye",
"district": "Bebek Mah.",
"contactName": "Esra Sevinç",
"phoneNumber": "05364604016",
"zipCode": "343400"
},
"shippingAddress": {
"emailAddress": "yilmaz@gmail.com",
"address": "Levent Mah. Nispetiye Cad. No:8 Beşiktaş",
"city": "İstanbul",
"companyName": "Yılmazlar Şirketi",
"country": "Türkiye",
"district": "Levent",
"contactName": "Nilüfer",
"phoneNumber": "05346484777",
"zipCode": "3434221"
},
"buyer": {
"ipAddress": "192.168.1.70",
"buyerId": "678654",
"name": "Yeşim",
"surName": "Çınar",
"identityNumber": 28629160374,
"city": "İstanbul",
"country": "Türkiye",
"zipCode": "348222",
"emailAddress": "yesim.cinar@gmail.com",
"phoneNumber": "0536460996",
"registrationAddress": "Ortaköy Mah. Ulus Sok. Beşiktaş",
"lastLoginDate": "2022-11-05T13:39:11.332",
"registrationDate": "2022-10-11T12:59:11.332"
},
"basket": {
"basketId": "736735353u3ye",
"basketItems": [
{
"itemId": "786543r453",
"name": "Lego Duplo",
"itemType": "PHYSICAL",
"category": "oyuncak",
"subCategory": "alt oyuncak",
"numberOfProducts": 1,
"totalPrice": 20,
"unitPrice": 1
}
]
},
"paymentGroup": "PRODUCT",
"securityHash”: “84839djf93klw00llr=="
}
API İstek Cevabı Örneği
{
"success": true,
"systemTime": "2025-08-09T16:11:08.435896462",
"correlationId": "Onxxxxx",
"securityHash": "37ZYmrHGXeKTfbHOtT/jHpNO5r20mCyRvktnxlWI3/M=",
"bankAuthCode": "2766xxx",
"bankReferenceNumber": "52210430xxxx",
"orderId": "RND0xxxx",
"amount": 5,
"currency": "TRY",
"installmentCount": 1,
"card": {
"binNumber": "55496007",
"maskedNumber": "5549-6007-xxxx-xx18",
"cardBrand": "T. GARANTİ BANKASI A.Ş.",
"cardOrganization": "MASTERCARD",
"cardType": "CREDIT"
},
"rewardAmount": 3
}
İstek Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| success | String | true dönmesi durumunda satış başarılı, false dönmesi durumunda hata alınmıştır. hata detayı error code ve error message alanlarında paylaşılacaktır. |
| systemTime | dateTime | işlem tarihi |
| correlationId | String | transaction numarası |
| orderId | String | sipariş numarası |
| amount | Number | işlem tutarı |
| currency | String | işlem para birimi |
| card/binNumber | String | kart ilk 8 hanesi |
| card/maskedNumber | String | maskeli kart no |
| card/cardBrand | String | kart markası |
| card/cardOrganization | String | kart organizasyonu |
| card/cardType | String | kart tipi |
| errorCode | String | hata kodu |
| errorMessage | String | hata mesajı |
| rewardAmount | String | Kullanılan Puan Tutarı |
| securityHash | String | İşlemin sonucunun doğru kaynaktan geldiğini belirlemek için kullanılacak değer. Belgeler bunun nasıl hesaplanması gerektiğini belirtir. |
| bankAuthCode | String | Banka Onay Kodu |
| bankReferenceNumber | String | İşleme ait Retref numarası |
| errorGroup | String | İlgili hatanın grubunu gösterir. İşyerleri hata kodu ve hata gruplarından faydalanarak kendi tarafındaki kuralları yönetebilir. |
POST
Merchant ID
Terminal ID
Secret Key
{
"orderId": "",
"amount": 415,
"isRewardToBeUsed": true,
"rewardToBeUsed": {
"list": [
{
"type": "BNS",
"amount": 10
}
]
},
"currency": "TRY",
"installmentCount": 1,
"motoInd": false,
"paymentGroup": "PRODUCT",
"paymentChannel": "WEB",
"card": {
"holderName": "Mesut Sarıtaş",
"cvv": "",
"expireMonth": 4,
"expireYear": 2026,
"number": "4824910501747014"
},
"billingAddress": {
"address": "Deneme adresi",
"city": "İstanbul",
"companyName": "Deneme Firması",
"country": "Türkiye",
"district": "Maltepe",
"contactName": "Oğuzhan Okur",
"phoneNumber": "07505555555",
"zipCode": "34846"
},
"shippingAddress": {
"address": "Deneme adresi",
"city": "İstanbul",
"companyName": "Deneme Firması",
"country": "Türkiye",
"district": "Maltepe",
"contactName": "Oğuzhan Okur",
"phoneNumber": "07505555555",
"zipCode": "34846"
},
"buyer": {
"ipAddress": "127.0.0.1",
"buyerId": "00c1a0169a8944d2bd0082e0a45c7b6a",
"name": "Oğuzhan",
"surName": "Okur",
"identityNumber": 11111111111,
"city": "İstanbul",
"country": "Türkiye",
"zipCode": "34846",
"emailAddress": "destek@garantibbva.com.tr",
"phoneNumber": "07325555555",
"registrationAddress": "Maltepe",
"lastLoginDate": "2024-11-06T17:43:19.329",
"registrationDate": "2024-10-27T17:43:19.329"
},
"basket": {
"basketId": "5d306547a5814d71b440e46c4b1a285e",
"basketItems": [
{
"itemId": "4388002",
"name": "Lego",
"itemType": "PHYSICAL",
"category": "Oyuncak",
"subCategory": "Çocuk Oyunu",
"numberOfProducts": 10,
"totalPrice": 30,
"unitPrice": 3
},
{
"itemId": "5647389393",
"name": "Piyano",
"itemType": "PHYSICAL",
"category": "Oyuncak",
"subCategory": "Alt Oyuncak",
"numberOfProducts": 5,
"totalPrice": 385,
"unitPrice": 77
}
]
}
}
Hata Oluştu
Başarılı
Security Hash Hesaplama
Yapılacak servis isteklerinde ve gelen servis cevaplarında securityHash alanının hesaplanması için buradaki dokümantasyondan yararlanabilirsin.
Kod Örnekleri
Aşağıda, çeşitli yazılım dilleri kullanılarak yazılmış özel kod örneklerinin linkleri verilmiştir. Tercih ettiğiniz programlama diline ait link üzerinden, önceden belirlenmiş değerlerle yazılmış olan kodları detaylı bir şekilde inceleyebilirsin.
Bu örnekler, ilgili işlem tipini içeren kodları içermektedir ve farklı dillerde yazıldığı için çeşitli yaklaşımları ve pratikleri de gözlemleyebilirsin. Bu sayede tercih ettiğiniz programlama diline dair daha iyi anlaşılır ve özgün örneklerle çalışma imkanı bulabilirsin.
C# Kod Örnekleri için tıklayınız.
VB.Net Kod Örnekleri için tıklayınız.
Java Kod Örnekleri için tıklayınız.
PHP Kod Örnekleri için tıklayınız.
NodeJS Kod Örnekleri için tıklayınız.
Unutmayın ki bu örnekler ön tanımlı değerlerle yazılmıştır ve gerçek projelerde kullanımı için gerekli uyarlama ve güvenlik önlemleri alman gerekebilir.
Hata Kodları
Hata kodları listesine bu sayfadan ulaşabilirsin.
Test Kartları
Test kartları listesine bu sayfadan ulaşabilirsin.
