POST /v1/Transaction/SendMoneyToBankAccount ile oluşturulan para çekme talimatlarının sonucu asenkron webhook bildirimleriyle iletilebilir.| Event | Açıklama |
|---|---|
WithdrawalTransferResult | Para çekme işleminin başarı, başarısızlık, iptal veya iade gibi sonuçlarını bu sayfada açıklanan özel payload ile bildirir. |
WithdrawCompleted | Yalnızca başarıyla tamamlanan para çekme işlemleri için standart SummaryRecord payload'ını gönderir. |
WithdrawalTransferResult eventinin etkinleştirilmesi, WithdrawCompleted eventini otomatik olarak etkinleştirmez. Her iki event de etkinse aynı başarılı işlem için iki ayrı webhook bildirimi gönderilebilir.Bu sayfanın devamı WithdrawalTransferResultwebhook payload'ını açıklamaktadır.SummaryRecordpayload'ı bu webhook'un payload'ı değildir.
{
"tenant_id": 5,
"amount": 25,
"currency_code": "TRY",
"ext_transaction_id": "EXT-EXAMPLE-001",
"request_withdraw_id": 2610095975284361006,
"transaction_id": 2610099713036521748,
"account_type_id": 1,
"account_number": "12345678",
"wallet_number": "87654321",
"before_process_status": 0,
"after_process_status": 1,
"money_transfer_state": 0,
"money_transfer_type": 3,
"to_iban": "TR000000000000000000000000",
"response_status": 0,
"response_code": "100",
"response_message": "İşlem başarılı",
"transaction_type": "A01",
"to_name": "EXAMPLE USER",
"reason": ""
}money_transfer_state = 0
after_process_status = 1
transaction_id > 0Pending → Completed akışında before_process_status = 0 olur. İşlem operasyonel süreç sonrasında tamamlanmışsa önceki statü farklı olabilir.money_transfer_state, before_process_status, after_process_status ve transaction_id alanları birlikte değerlendirilmelidir.| Sonuç | money_transfer_state | before_process_status | after_process_status | Açıklama |
|---|---|---|---|---|
| Başarılı | 0 | Genellikle 0 veya 3 | 1 | İşlem tamamlanmıştır ve transaction_id > 0 olmalıdır. |
| Provider başarısızlığı / operasyonel işlem | 1 | Genellikle 0 | 3 | Finansal olarak kesin değildir; daha sonra başarılı veya iptal edilmiş duruma geçebilir. |
| İptal | 4 | Genellikle 0 veya 3 | 2 | İşlem iptal edilmiştir ve aktif fund-out bulunmamaktadır. |
| Başarılı işlem sonrası iade | 5 | 1 | 2 | Daha önce tamamlanmış payout banka tarafından iade edilmiştir. |
after_process_status = 5iade anlamına gelmez. Bu değerClosedManuallystatüsüdür.
Completed bildirimi, işlem daha önce tamamlandıktan sonra tekrar alınabilir. Böyle bir bildirim aşağıdaki değerleri içerebilir:before_process_status = 1
after_process_status = 1
money_transfer_state = 0
response_status = 2
response_code = "312"SendMoneyToBankAccount isteği, payout talimatı kabul edilmeden önce hata ile reddedilirse webhook gönderilmez. Örneğin:{
"status": 2,
"code": "311",
"message": "Cüzdan bakiyeniz yetersiz olduğundan işlemi gerçekleştiremiyoruz"
}money_transfer_state = 1
after_process_status = 3Completed veya Rejected/Cancelled durumuna geçebilir. Güncel durum GetRequestWithdrawByExtId ile takip edilmelidir.money_transfer_state = 4
after_process_status = 2ext_transaction_id için yeni bir webhook gönderilir:money_transfer_state = 5
before_process_status = 1
after_process_status = 2
transaction_id > 0GetRequestWithdrawByExtId aşağıdaki değeri döndürebilir:process_level_status = 3Failed sonucu gönderirse money_transfer_state = 1 ve after_process_status = 3 içeren bir WithdrawalTransferResult webhook'u alınabilir.response_* alanlarıresponse_status, response_code ve response_message, provider bildirimine ait finansal sonucu değil, bildirimin platform tarafından nasıl işlendiğini açıklar.money_transfer_state
before_process_status
after_process_status
transaction_idWithdrawalTransferResult webhook'udur. Webhook alınamazsa, sonuç belirsizse veya mutabakat gerekiyorsa aynı ext_transaction_id ile aşağıdaki servis kullanılmalıdır:process_level_status değerleri:| Değer | Durum | Açıklama |
|---|---|---|
0 | Pending | İşlem devam etmektedir; finansal olarak kesin değildir. |
1 | Completed | Payout tamamlanmıştır. Daha sonra ayrı bir iade bildirimi gelebilir. |
2 | Rejected | Aktif fund-out bulunmamaktadır. İlk ret/iptal veya sonradan gerçekleşen iade olabilir. |
3 | Failed / Operational Processing | Finansal olarak kesin değildir; sorgulamaya devam edilmelidir. |
4 | Cancelled | İşlem iptal edilmiştir ve aktif fund-out bulunmamaktadır. |
5 | ClosedManually | Finansal sonucu tek başına belirlemez; operasyon/destek teyidi gerekir. |
process_level_status = 3 terminal durum değildir.2xx yanıtı başarılı teslim onayı olarak kabul edilir.ext_transaction_id ile tekilleştirilmemelidir. Başarılı işlem ve daha sonra gerçekleşen iade aynı ext_transaction_id değerini kullanır.ext_transaction_id
+ money_transfer_state
+ after_process_status
+ transaction_idCompleted bildirimi ikinci bir finansal aksiyon başlatmamalıdır.Refunded bildirimi mutlaka işlenmelidir.Completed bildirimi, daha önce işlenmiş Refunded sonucunun üzerine yazmamalıdır.