Fintech Suite · Bilgi merkezi

idempotency nedir?

Idempotency, aynı mantıksal işlemin uygun kimlik ve parametrelerle birden fazla kez çağrılmasının ek bir finansal etki oluşturmadan tek işlem etkisini koruması özelliğidir; ödeme API'lerinde anahtarın kapsamı, saklama süresi ve eşzamanlı istek davranışı sözleşmeyle belirlenir, farklı sağlayıcılarda veya süresi dolmuş anahtarlarda kendiliğinden geçerli bir garanti değildir.

Nasıl çalışır? Bir örnek

Varsayımsal örnek: Bir uygulama 4.800 TL tutarındaki tahsilatı benzersiz bir işlem anahtarıyla başlatsın, ancak yanıt ağda kaybolsun. Sağlayıcının belgelenmiş idempotency desteği varsa aynı anahtar ve aynı parametrelerle yapılan teknik tekrar yeni tahsilat oluşturmamalıdır. Tutarı 5.000 TL yaparak aynı anahtarı kullanmak farklı bir talebi gizlemek olur. Ekip iki eşzamanlı çağrıyı, anahtar süresinin dolmasını ve başka sağlayıcıya geçişi ayrı test eder; kapsam dışındaki tekrarları güvenli kabul etmez.

Sık karıştırılan terimler

  • API anahtarı: API anahtarı çağıran uygulamanın kimlik doğrulamasında kullanılır; idempotency anahtarı belirli bir işlemi tanımlar, bu iki değer aynı amaçla paylaşılmaz veya birbirinin yerine gönderilmez.
  • kesintisiz ödeme (failover): Failover alternatif bağlantı seçer; aynı idempotency anahtarını iki bağımsız sağlayıcıya göndermek ortak tekilleştirme oluşturmaz, belirsiz ilk işlemin durumu ayrıca çözülmelidir.

İlgili terimler

webhook · API anahtarı · kesintisiz ödeme (failover) · ödeme orkestrasyonu

MagicPay'de nasıl çalışır?

MagicPay Fintech Suite'in Ödeme Tekrarı ürünü, denemeleri ortak ticari işlemle ilişkilendirmeyi ve belirsiz sonuçta önce durum sorgulamayı esas alır. Bu yaklaşım bütün MagicPay uçlarında belgelenmiş idempotency garantisi olduğu anlamına gelmez; anahtar, süre ve tekrar sözleşmesi kullanılan API ile sağlayıcı için ayrıca doğrulanmalı, uygulama tekilleştirmesi de test edilmelidir.

Güvenli tekrar yaklaşımını inceleyin

Kaynaklar