Tami Developer Portal

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?

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?

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.

Tami API

E-Ticaret Çözümlerimiz

API Bul

Satış

Sorgulama

İptal/İade

Kapama

Security Hash

Ortak Ödeme Sayfası

Linkli Ödeme

Kolay Entegrasyon,
Kolay Yazılım.

Sıkça Sorulan Sorular