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": 7193628450192736815,
"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ı#
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" }
2.
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": 7193628450192736815,
"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.
Modified at 2025-07-24 12:46:24