Bankaya Para Transferi Webhook

✅ Başarılı İşlem Sonrası Webhook

Eğer /v1/Transaction/SendMoneyToBankAccount servisi başarılı yanıt dönerse ve işlem banka tarafından da başarıyla gerçekleşirse aşağıdaki gibi bir webhook gönderimi yapılır:

{
"tenant_id": 5,
"amount": 50,
"currency_code": "TRY",
"ext_transaction_id": "54171323223317131311333332552",
"request_withdraw_id": 2505267108142371608,
"transaction_id": 2505266701488343592,
"account_type_id": 2,
"account_number": "12345678",
"wallet_number": "23456789",
"before_process_status": 1,
"after_process_status": 1,
"money_transfer_state": 0,
"money_transfer_type": 3,
"to_iban": "TR000000000000000000000000",
"response_status": 2,
"response_code": "312",
"response_message": "Bu işlem daha önce başarıyla gerçekleştirilmiştir.",
"transaction_type": "A01",
"to_name": "Fxxxx",
"reason": "Basarili"
}

after_process_status = 1 ve transaction_id > 0 → İşlem başarıyla tamamlanmış demektir.

Ancak nadiren, bankadan iade durumu oluşabilir. Bu durumda aynı işlem için:

after_process_status = 5 ile webhook gönderilir. Bu iade işlemidir, başarısızlık değildir.

❌ Başarısız İşlem Senaryoları

API Çağrısı Başarısızsa:

Servis response’u hata ile dönerse (ör. bakiye yetersizliği), webhook gönderilmez.

Örnek hata:
{ "status": 2, "code": "311", "message": "Cüzdan bakiyeniz yetersiz olduğundan işlemi gerçekleştiremiyoruz" }

API Çağrısı Başarılı ama İşlem Bankada Reddedilirse:

Bu durumda after_process_status = 2 veya 4 olur.

Webhook gönderilir, ancak işlem durumu “başarısız” olarak değerlendirilir:

{
"tenant_id": 5,
"amount": 50,
"currency_code": "TRY",
"ext_transaction_id": "54171323223317131311333332552",
"request_withdraw_id": 2505267108142371608,
"transaction_id": 2505266701488343592,
"account_type_id": 2,
"account_number": "12345678",
"wallet_number": "23456789",
"before_process_status": 1,
"after_process_status": 2,
"money_transfer_state": 0,
"money_transfer_type": 3,
"to_iban": "TR000000000000000000000000",
"response_status": 2,
"response_code": "312",
"response_message": "Bu işlem daha önce başarıyla gerçekleştirilmiştir.",
"transaction_type": "A01",
"to_name": "Fxxx",
"reason": "Basarili"
}

⚠️ Manuel Onay Süreci (Operasyonel Durum)

Eğer işlem manuel operasyona düşerse, webhook gönderimi yapılmaz.

after_process_status = 3 olur.

Operasyon ekibi manuel onaylar; işlem takibi için ext_transaction_id ile GetRequestWithdrawByExtId servisine istek atılmalıdır.

Bu durum genellikle IBAN, ad-soyad uyumsuzluğu gibi manuel müdahale gerektiren senaryolarda görülür.

📌 Önemli Notlar

Webhook’lar her durumda asenkron gönderilir.

Mutlak güvence için işlem durumu ayrıca GetRequestWithdrawByExtId servisinden kontrol edilmelidir.

✅ Başarılı İşlem Sonrası Webhook#

❌ Başarısız İşlem Senaryoları#

⚠️ Manuel Onay Süreci (Operasyonel Durum)#

📌 Önemli Notlar#

✅ Başarılı İşlem Sonrası Webhook

❌ Başarısız İşlem Senaryoları

⚠️ Manuel Onay Süreci (Operasyonel Durum)

📌 Önemli Notlar