Tami Developer Portal

Servislere istek atarken header kısmında hangi alanları iletmeliyim? Servislere istek atarken header kısmında hangi alanları iletmeliyim?

Key	Value
correlationId	Correlation{{randomNumber}}
PG-Auth-Token	{{merchantNumber}}:{{terminalNumber}}:{{hash}}
PG-Api-Version	V2

Header kısmında correlationId ve PG-Auth-Token parametrelerinin iletilmesi beklenir. correlationId her işlem için string unique bir değer iletilmelidir. PG-Auth-Token parametresi de tabloda belirtildiği gibi işyerine ait merchantNumber, terminalNumber ve hash bilgilerinden oluşur. Hash bilgisi için de işyerine ait merchantNumber, terminalNumber ve secretKey bilgileri sha256 ile hashleyip stringe çevrilerek elde edilir.

Satış işleminde, ErrorMessage etiketi içerisinde "Security Hash alanının iletilmesi zorunludur. Kontrol ederek tekrar deneyiniz" hata mesajı aldığımızda ne yapmalıyız? Satış işleminde, ErrorMessage etiketi içerisinde "Security Hash alanının iletilmesi zorunludur. Kontrol ederek tekrar deneyiniz" hata mesajı aldığımızda ne yapmalıyız?

Response

{

"errorCode": 4015,

"errorMessage": "Security Hash alanının iletilmesi zorunludur. Kontrol ederek tekrar deneyiniz",

"success": false,

"systemTime": "2024-03-30T12:08:40.526596076",

"correlationId": "correlation9975",

"SecurityHash": "qSHq2JE7cmxqYx+2x4FSBaR6q2fqRhUFlA9uVmuinL4="

}

Alınan hata requestte gönderilmesi beklenen SecurityHash değeri gönderilmediğinde alınan hatadır. Request içerisinde "securityHash" parametresinin istenen değerlere göre hesaplanarak iletilmesi beklenir. Bu alanları kontrol ederek yeniden işlem denemenizi ve hatanın devamı halinde SecurityHash değerini oluşturan alanları ve oluşturduğunuz hash değerini tarafımıza göndermenizi rica ederiz.

Satış işleminde, ErrorMessage etiketi içerisinde "Headerda gönderilen hash değeri tutarsız" hata mesajı aldığımızda ne yapmalıyız? Satış işleminde, ErrorMessage etiketi içerisinde "Headerda gönderilen hash değeri tutarsız" hata mesajı aldığımızda ne yapmalıyız?

Response

{

"errorCode": 4003,

"errorMessage": "Headerda gönderilen hash değeri tutarsız",

"success": false ,

"systemTime": "2024-05-07T13:22:49.941660017",

"correlationId": "correlation94003a3b-5efc-4f34-b0f3-0ee531ebeb6e",

"SecurityHash": "8595jhq4fhd78orllA9uVmuinL4="

}

Satış, İptal/İade, Ön Otorizasyon, Ön Otorizasyon kapama, 3D'li satış ve 3D'li satış tamamlama isteklerinin tümünde header'da "PG-Auth-Token" parametresi iletilmeli.

Bu bilgi üye işyerine ait "merchantNumber:TerminalNumber:Hash" bilgilerinden oluşmaktadır. Hash bilgisinin istenen değerlere göre hesaplanarak PG-Auth-Token parametresine eklenmesi beklenir.

3d'li Satış işleminde 3D doğrulama adımında dönen mdStatus bilgisi nedir? 3d'li Satış işleminde 3D doğrulama adımında dönen mdStatus bilgisi nedir?

3D Secure kimlik doğrulama işlemi sırasında oluşabilecek bir hata mesajıdır. 3D Secure sisteminden mdStatus kodunun "1" olarak dönmesi, işlemin "Full Secure" olduğu yani kart sahibine gönderilen kodun girilerek devam edildiği anlamına gelmektedir.

Full Secure haricindeki durumlarda işlem ya reddedilir ya da half secure doğrulama cevabı işyerine döner.

Diğer mdStatus değerleri ve açıklamaları da aşağıdadır.

mdStatus	Açıklama
mdStatus = 0	3-D Secure imzası geçersiz veya doğrulama
mdStatus = 2	Kart sahibi veya bankası sisteme kayıtlı değil
mdStatus = 3	Kartın bankası sisteme kayıtlı değil
mdStatus = 4	Doğrulama denemesi, kart sahibi sisteme daha sonra kayıt olmayı seçmiş
mdStatus = 5	Doğrulama yapılamıyor
mdStatus = 6	3-D Secure hatası
mdStatus = 7	Sistem hatası
mdStatus = 8	Bilinmeyen kart no

Satış işleminde ErrorMessage etiketi içerisinde "Bu terminal için taksitli satış yetkisi bulunmamaktadır" hata mesajı aldığımızda ne yapmalıyız? Satış işleminde ErrorMessage etiketi içerisinde "Bu terminal için taksitli satış yetkisi bulunmamaktadır" hata mesajı aldığımızda ne yapmalıyız?

Response

{

"errorCode": 2011,

"errorMessage": "Bu terminal için taksitli satış yetkisi bulunmamaktadır.",

"success": false ,

"systemTime": "2024-05-07T13:22:49.941660017",

"correlationId": "correlation94003a3b-5efc-4f34-b0f3-0ee531ebeb6e",

"SecurityHash": "8595jhq4fhd78orllA9uVmuinL4="

}

Üye işyeri taksitli işlem yapabilmesi için Tami'deki posunun taksit yetkisinin açık olması gerekir. Bu hatayı aldığınızda taksit yetkisi açılması talebi için Tami ile iletişime geçebilirsiniz.

3d'li işlemde doğrulama sonucunda başarılı olan bir işlem için ne yapılması gerekiyor? 3d'li işlemde doğrulama sonucunda başarılı olan bir işlem için ne yapılması gerekiyor?

3D doğrulama adımı sonucunda başarılı olan işlemde karttan para çekimi henüz gerçekleşmez. İşlemin tamamlanması için 3D doğrulaması başarılı sonuçlanan sipariş numarası bilgisi ile /complete-3ds servisinin çağrılması gerekmektedir.

E-ticaret Destek

Sıkça Sorulan Sorular

Sıkça Sorulan Sorular