Ana içeriğe geç

Anlık Ödeme Bildirimi

Ödeme sonuçlandıktan sonra satıcı panelinde mağazaya ait geri dönüş adresine HTTP protokolü üzerinden POST isteği gönderir.

İsteği doğrulamak için satıcı panelinde mağazaya ait parola (api key) ve gizli anahtar (api secret) gerekir.

Gönderilen verileri başarıyla işlediğinize dair dönmeniz gereken yanıt (response) içinde düz yazı formatında ve yalnızca OK değeri ile cevap vermelisiniz. Aksi takdirde işlemin size başarıyla iletilemediği algılanacaktır. Aynı işlem için bildirim sürekli olarak devam edecektir.

İstek Parametreleri#

ParametreTipAçıklama
orderIdintegerÖdeme işlemine ait sistem tarafından verilen benzersiz değerdir.
paymentAmountintegerÖdemeye ait tutar
conversationIdstringÖdeme başlatılırken gönderip, sonuçta aldığınız değer, eşleşme yapmak için kullanılır
userIdintegerÖdeme başlatılırken gönderilen üye işyeri tarafındaki kullanıcıya ait ID
statusbooleanÖdemenin durumunu belirtir. Parametre SUCCESS ve FAILURE değerlerini alabilir
hashstringSistem tarafından gönderilen ödeme sonucuna ait hash

Hash değerinin oluşturulması#

Hash değeri hesaplanırken HMAC SHA256 ve HMAC MD5 algoritmaları kullanılır.

Gereken Parametreler#

ParametreTipAçıklama
apiKeystringSisteme kayıtlı olan mağazanın parolası (api key)
apiSecretstringSisteme kayıtlı olan mağazanın gizli anahtarı (api secret)
conversationIdstringÖdeme başlatılırken gönderip, sonuçta aldığınız değer, eşleşme yapmak için kullanılır
userIdintegerÖdeme başlatılırken gönderilen üye işyeri tarafındaki kullanıcıya ait ID
statusbooleanÖdemenin durumunu belirtir. Parametre success ve failure değerlerini alabilir
paymentAmountintegerÖdemeye ait tutar

Örnek Kod#

hash_hmac('md5', hash_hmac('sha256', "$conversationId|$orderId|$paymentAmount|$status|$userId".$apiSecret, $apiKey), $apiKey);