-
Sanal Pos
Genel Açıklama
Buraya Tami Sanal Pos Hakkında Genel Açıklama Eklenecektir.
Hash Hesaplama
Hash hesaplanırken merchantNumber + terminalNumber + secretKey bilgileri metin ifadesi olarak uç uca eklenir. Birleştirilmiş bu ifade daha sonrasında SHA-256 methodu ile şifrelenir ve daha sonrasında şifrelenen veri base64 metin ifadesine dönüştürülür.
Test bilgileri yukarıdaki ortam bilgileri kısmında paylaşılmıştır.
Hash hesabı yapılan veri;
İstekler gönderilirken header bilgisine PG-Auth-Token değeri aşağıdaki formatta eklenmiş olması gerekmektedir.
PG-Auth-Token : "merchantNumber:terminalNumber:hash"
“Hash hesaplamasında kullanılacak generator aşağıda verilmiştir.”:
public class SHA256Example {\n public static String sha256(Long merchantNumber, Long terminalNumber, String secretKey) {\n String text = merchantNumber.toString() + terminalNumber.toString() + secretKey;\n try {\n MessageDigest digest = MessageDigest.getInstance(\"SHA-256\");\n byte[] hash = digest.digest(text.getBytes(StandardCharsets.UTF_8));\n String sha256Hex = DatatypeConverter.printBase64Binary(hash);\n return sha256Hex;\n } catch (NoSuchAlgorithmException e) {\n e.printStackTrace();\n return null;\n }\n }\n
TAMİ Test Portalı Bilgileri
Tami test portalına https://pagoportal-t.garantibbva.com.tr adresinden erişebilirsiniz.Bu adresten üye olarak başvuru yapabilir ve portal ekranlarını görüntüleyebilirsiniz.
Üretim ortamı bilgileriniz için eticaret destek birimine başvuruda bulunabilirsiniz.
Test Ortamı API Kullanıcısı Bilgileri
| Alan | Veri |
|---|---|
| Merchant ID | 770000678 |
| Terminal ID | 840000678 |
| Secret Key | a3e9a5ab-f3e1-43d1-9a12-f702ada09411 |
Önemli Bilgilendirme: Secret Key bilgisi her terminal için farklılık göstermektedir.
Ön Otorizasyon
Tami üzerinden gerçekleştirilmek istenen ödeme için belirtilen tutar kadar karttan bakiyenin bloke edilmesini sağlar
Ön Otorizasyon İşlemi API Bilgileri
Test Ortamı Bağlantısı:\nhttps://pagoapi-t.garantibbva.com.tr/payment/pre-auth\n\nÜretim Ortamı Bağlantısı:\nhttps://pagoapi.garantibbva.com.tr/payment/pre-auth
İstek Parametreleri ve Açıklamaları
| Alan | 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. |
| amount | Decimal | Z | İşlem 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. |
| installmentCount | Number | (1-99) | Z | Taksit bilgisi, tek çekim için 1 gönderilmelidir. |
| paymentGroup | String | Z | Ödeme grubu, varsayılan PRODUCT. Geçerli değerler enum içinde sunulmaktadır: PRODUCT, LISTING, SUBSCRIPTION, OTHER | |
| paymentChannel | enum | O | Ö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 | |
| callbackUrl | String | O | İşlem 3d yapılmak isteniyorsa gönderilmelidir. | |
| 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 | O | ||
| ipAddress | String | Ş | Alıcıya ait ip adresi. Buyer objesi opsiyonel bir alandır fakat buyer objesinden herhangi bir alan gönderilse ipAddress iletilmesi zorunlu olur. | |
| buyerId | String | 50 | Ş | Üye işyeri tarafındaki alıcıya ait id. Buyer objesi opsiyonel bir alandır fakat buyer objesinden herhangi bir alan gönderilse buyerId iletilmesi zorunlu olur. |
| name | String | 30 | Ş | Ü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 | 30 | Ş | Ü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 | 11 | O | Üye işyeri tarafındaki alıcıya ait kimlik (TCKN) numarası. |
| city | String | 50 | O | Üye işyeri tarafındaki alıcıya ait şehir bilgisi. |
| country | String | 50 | O | Üye işyeri tarafındaki alıcıya ait ülke bilgisi. |
| emailAddress | String | Ş | Ü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. Buyer objesi opsiyonel bir alandır fakat buyer objesinden herhangi bir alan gönderilse emailAddress iletilmesi zorunlu olur. | |
| phoneNumber | String | O | Üye işyeri tarafındaki alıcıya ait GSM numarası. | |
| registrationAddress | String | 400 | O | Üye işyeri tarafındaki alıcıya ait kayıt adresi. |
| zipCode | String | 15 | O | Üye işyeri tarafındaki alıcıya ait posta kodu. |
| registrationDate | Date | 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 | Date | 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 | 50 | Ş | Üye işyeri tarafındaki sepete ait id. Basket içerisinde item iletilirse basketId gönderilmesi zorunlu olur. |
| basket/basketItems | List | 0 | ||
| itemId | String | 50 | Ş | Üye işyeri tarafındaki sepetteki ürüne ait id. Basket içerisinde item iletilirse itemId gönderilmesi zorunlu olur. |
| itemType | String | 50 | Ş | Ü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 | 50 | Ş | Üye işyeri tarafındaki sepetteki ürüne ait ismi. Basket içerisinde item iletilirse name gönderilmesi zorunlu olur. |
| category | String | 50 | O | Üye işyeri tarafındaki sepetteki ürüne ait kategori . |
| subCategory | String | 100 | 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. Basket içerisinde item iletilirse totalPrice gönderilmesi zorunlu olur. Unitprice * numberOfProducts = totalPrice olmalı |
| numberOfProducts | Number | 1-99999 | O | Üye işyeri tarafındaki sepetteki ürünün adedidir. adet x unitprice = totalPrice olmalıdır. |
API İstek Örneği
{\n \"amount\": 20,\n \"orderId\": \"7707670050778\",\n \"currency\": \"TRY\",\n \"installmentCount\": 5,\n \"card\": {\n \"holderName\": \"Nilüfer Ataseven\",\n \"cvv\": \"\",\n \"expireMonth\": 12,\n \"expireYear\": 2026,\n \"number\": \"5406675406675403\"\n },\n \"billingAddress\": {\n \"emailAddress\": \"esrasevinc@gmail.com\",\n \"address\": \"İnşirah sok. No:70 Etiler/Beşiktaş\",\n \"city\": \"İstanbul\",\n \"companyName\": \"Yılmazlar A.Ş\",\n \"country\": \"Türkiye\",\n \"district\": \"Bebek Mah.\",\n \"contactName\": \"Esra Sevinç\",\n \"phoneNumber\": \"05364604016\",\n \"zipCode\": \"343400\"\n },\n \"shippingAddress\": {\n \"emailAddress\": \"yilmaz@gmail.com\",\n \"address\": \"Levent Mah. Nispetiye Cad. No:8 Beşiktaş\",\n \"city\": \"İstanbul\",\n \"companyName\": \"Yılmazlar Şirketi\",\n \"country\": \"Türkiye\",\n \"district\": \"Levent\",\n \"contactName\": \"Nilüfer\",\n \"phoneNumber\": \"05346484777\",\n \"zipCode\": \"3434221\"\n },\n \"buyer\": {\n \"ipAddress\": \"192.168.1.70\",\n \"buyerId\": \"678654\",\n \"name\": \"Yeşim\",\n \"surName\": \"Çınar\",\n \"identityNumber\": 28629160374,\n \"city\": \"İstanbul\",\n \"country\": \"Türkiye\",\n \"zipCode\": \"348222\",\n \"emailAddress\": \"yesim.cinar@gmail.com\",\n \"phoneNumber\": \"0536460996\",\n \"registrationAddress\": \"Ortaköy Mah. Ulus Sok. Beşiktaş\",\n \"lastLoginDate\": \"2022-11-05T13:39:11.332\",\n \"registrationDate\": \"2022-10-11T12:59:11.332\"\n },\n \"basket\": {\n \"basketId\": \"736735353u3ye\",\n \"basketItems\": [\n {\n \"itemId\": \"786543r453\",\n \"name\": \"Lego Duplo\",\n \"itemType\": \"PHYSICAL\",\n \"category\": \"oyuncak\",\n \"subCategory\": \"alt oyuncak\",\n \"numberOfProducts\": 2,\n \"totalPrice\": 1,\n \"unitPrice\": 0.5\n },\n {\n \"itemId\": \"7d7edsk877e\",\n \"name\": \"Yapboz\",\n \"itemType\": \"PHYSICAL\",\n \"category\": \"oyuncak\",\n \"subCategory\": \"alt oyuncak\",\n \"numberOfProducts\": 1,\n \"totalPrice\":11,\n \"unitPrice\": 10\n },\n {\n \"itemId\": \"dasdasdas\",\n \"name\": \"basketname1\",\n \"itemType\": \"PHYSICAL\",\n \"category\": \"oyuncak\",\n \"subCategory\": \"alt oyuncak\",\n \"numberOfProducts\": 1,\n \"totalPrice\": 8,\n \"unitPrice\": 9\n }\n ]\n },\n \"paymentGroup\": \"PRODUCT\"\n}
API İstek Cevabı Örneği
{\n \"success\": true,\n \"systemTime\": \"2023-09-15T14:00:35.575\",\n \"correlationId\": \"correlation4972\",\n \"orderId\": \"77005136siparis807670050778\",\n \"amount\": 20,\n \"currency\": \"TRY\",\n \"installmentCount\": 5,\n \"card\": {\n \"binNumber\": \"54066754\",\n \"maskedNumber\": \"5406-6754-xxxx-xx03\",\n \"cardBrand\": \"DİĞER BANKA\",\n \"cardOrganization\": \"MASTER\",\n \"cardType\": \"CREDIT\"\n }\n}
İ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 |
| installmentCount | Number | işlem taksit sayısı |
| 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 |
| fraudStatus | Integer | işlemin fraud kontrol sonucu OK/NOK |
| errorCode | String | hata kodu |
| errorMessage | String | hata mesajı |
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 inceleyebilirsiniz.
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özlemleyebilirsiniz. Bu sayede tercih ettiğiniz programlama diline dair daha iyi anlaşılır ve özgün örneklerle çalışma imkanı bulabilirsiniz.
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.
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ız gerekebilir.
Test Kartları
Test kartları listesine bu sayfadan ulaşabilirsiniz.
