POST /v1/Transaction/SendMoneyToBankAccount can be reported through asynchronous webhook notifications.| Event | Description |
|---|---|
WithdrawalTransferResult | Reports payout results such as completion, failure, cancellation, and refund using the dedicated payload documented on this page. |
WithdrawCompleted | Sends the standard SummaryRecord payload only for successfully completed payouts. |
WithdrawalTransferResult does not automatically enable WithdrawCompleted. If both events are enabled, a successful payout may generate two separate webhook notifications.The remainder of this page documents the WithdrawalTransferResultwebhook payload. TheSummaryRecordpayload is not the payload of this webhook.
{
"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 flow, before_process_status = 0. The previous status may be different if the payout was completed following operational processing.money_transfer_state, before_process_status, after_process_status, and transaction_id together.| Outcome | money_transfer_state | before_process_status | after_process_status | Description |
|---|---|---|---|---|
| Completed | 0 | Usually 0 or 3 | 1 | The payout is completed and transaction_id should be greater than zero. |
| Provider failure / operational processing | 1 | Usually 0 | 3 | Not financially final; the payout may later become Completed or Rejected/Cancelled. |
| Cancelled | 4 | Usually 0 or 3 | 2 | The instruction is cancelled and there is no outstanding fund-out. |
| Refund after completion | 5 | 1 | 2 | A previously completed payout was refunded by the bank. |
after_process_status = 5does not indicate a refund. It represents theClosedManuallystatus.
Completed notification may be received again after the payout has already been processed. Such a notification may contain:before_process_status = 1
after_process_status = 1
money_transfer_state = 0
response_status = 2
response_code = "312"SendMoneyToBankAccount rejects the request before the payout instruction is accepted, no webhook is generated. For example:{
"status": 2,
"code": "311",
"message": "Cüzdan bakiyeniz yetersiz olduğundan işlemi gerçekleştiremiyoruz"
}money_transfer_state = 1
after_process_status = 3Completed or Rejected/Cancelled following operational processing. Use GetRequestWithdrawByExtId to track the current status.money_transfer_state = 4
after_process_status = 2ext_transaction_id:money_transfer_state = 5
before_process_status = 1
after_process_status = 2
transaction_id > 0GetRequestWithdrawByExtId may return:process_level_status = 3Failed result, a WithdrawalTransferResult webhook with money_transfer_state = 1 and after_process_status = 3 may be received.response_* fieldsresponse_status, response_code, and response_message describe how the provider notification was processed by the platform. They do not directly represent the provider's financial outcome.money_transfer_state
before_process_status
after_process_status
transaction_idWithdrawalTransferResult webhook. If the webhook is not received, the result is ambiguous, or reconciliation is required, use the following service with the same ext_transaction_id:process_level_status values:| Value | Status | Description |
|---|---|---|
0 | Pending | Processing continues; not financially final. |
1 | Completed | The payout is completed. A separate refund notification may still arrive later. |
2 | Rejected | There is no outstanding fund-out. It may represent an initial rejection/cancellation or a later refund. |
3 | Failed / Operational Processing | Not financially final; continue checking the status. |
4 | Cancelled | The payout is cancelled and there is no outstanding fund-out. |
5 | ClosedManually | Does not determine the financial outcome by itself; operations/support confirmation is required. |
process_level_status = 3 is not a terminal state.2xx response acknowledges successful receipt.ext_transaction_id alone. A successful payout and a later refund use the same ext_transaction_id.ext_transaction_id
+ money_transfer_state
+ after_process_status
+ transaction_idCompleted notification must not trigger another financial action.Refunded notification must still be processed.Completed notification must not overwrite an already processed Refunded result.