Ödeme API entegrasyonunda bir isteğin HTTP düzeyinde başarılı olması finansal işlemin tamamlandığını her zaman göstermez. Uygulamanız; teknik yanıtı, ödeme durumunu ve sipariş sonucunu ayrı değerlendirmelidir. Bu sayfa örnek bir tasarım kontrol listesidir; doğrulanmamış endpoint veya çalışır erişim anahtarı sunmaz.
İstek modelini netleştirin
Tutarın birimi, para birimi hassasiyeti ve ticari işlem referansının benzersizliği güncel API sözleşmesinden okunmalıdır. Varsayılan tutar formatı veya alan adıyla canlı istek gönderilmemelidir.
- Kimlik doğrulama yöntemini ve anahtar yenileme akışını teyit edin.
- Idempotency kapsamını istemci ve sağlayıcı için doğrulayın.
- Zaman aşımı ve yeniden deneme kurallarını ayrı belirleyin.
Bildirimleri güvenli işleyin
Webhook imzası veya doğrulama yöntemi güncel sözleşmeye göre uygulanmalıdır. Aynı olayın tekrar gelmesi ve olay sırasının değişmesi test edilmelidir. Bildirimin alınmasıyla ticari kaydın işlenmesi ayrı izlenebilir olmalıdır.
Sonuç ve finansal teyit
Belirsiz işlemlerde durum sorgusu kullanılarak kesin sonuç araştırılır. İptal ve iade cevapları da aynı ticari referansa bağlanır. Canlı bağlantı bilgileri teknik kapsam netleştikten sonra güvenli kanaldan paylaşılmalıdır.