-
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.
3D'li İşlem Tamamlama
TAMİ üzerinden gerçekleştirilen 3D'li işlemi 2 aşamalıdır. İlk olarak 3D'li satış işlemi başlatılır ve bu işlemin sonucunda servisten html content bilgisi döner ve bu content base64 de decode edilerek bir html elde edilir. Bu html ile 3D doğrulama sayfasına yönlendirilir ve burada doğrulama kodu girilerek 3D doğrulama sonucu görülür. Başarılı 3D doğrulaması yapılmış bir işlemin satışa dönüşmesi için 3D Complete servisi çağırılarak işlem sonlandırılmış olur.
3D'li İşlem Tamamlama İşlemi API Bilgileri
Test Ortamı Bağlantısı:\nhttps://pagoapi-t.garantibbva.com.tr/payment/complete-3ds\n\nÜretim Ortamı Bağlantısı:\nhttps://pagoapi.garantibbva.com.tr/payment/complete-3ds
İstek Parametreleri ve Açıklamaları
| Alan | Format | Uzunluk | (O)psiyonel / (Z)orunlu | Description |
|---|---|---|---|---|
| orderId | String | (2-36) | Z | Ödeme isteğinin PAGO-client arasındaki iletişiminde kullanılan tekil bir iletişim bilgisidir. |
| Üye işyeri ve terminal çifti için tekil olmalıdır. | ||||
| amount | Decimal | O | 3d işlemini başlatan ve bitiren modül farklı olduğu durumda frontend ve backend ekiplerinin tutar doğrulaması için kullanması amacıyla eklenmiştir. Küsurat ayracı nokta (.) ile yapılmalıdır. Eğer amount gönderilmezse 3d başlatma requestindeki tutar üzerinden provizyona çıkılır. Gönderilirse 3d başlatma requestindeki tutarla eşit olması beklenmektedir. Farklı olduğu durumda hata verilir. "errorCode": 2031, "errorMessage": "3D işlemindeki tutar ile gönderilen tutar aynı değildir!" |
API İstek Örneği
{\t\n \"orderId\": \"9a6gsaas4asd9bb7ab46782\"\n}
API İstek Cevabı Örneği
{\n \"success\": true,\n \"systemTime\": \"2023-08-10T11:40:02.299\",\n \"correlationId\": \"ENESKOKSALMISTEST9962\",\n \"orderId\": \"9a6gsaas4asd9bb7ab46782\",\n \"amount\": 415,\n \"currency\": \"TRY\",\n \"installmentCount\": 1,\n \"card\": {\n \"binNumber\": \"48249105\",\n \"maskedNumber\": \"4824-9105-xxxx-xx14\",\n \"cardBrand\": \"Garanti\",\n \"cardOrganization\": \"VISA\",\n \"cardType\": \"CREDIT\"\n }\n}
İstek Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| errorCode | String | hata kodu |
| errorMessage | String | hata mesajı |
| 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 |
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.
