Top-up Webhook

✅ Successful Top-up Webhook

If a successful top-up is made with an personal account, the following webhook body is sent::

{
  "id": 2507225317817012915,
  "tenant_id": 7193628450192736815,
  "tx_group_correlation_id": 0,
  "tx_ref_correlation_id": 0,
  "wallet_id": 7546260134048689165,
  "transaction_type_id": 1001,
  "transaction_type": "Topup Bank Transfer | IsCashinTx = true",
  "transaction_status_id": 20,
  "transaction_status": "NormalCompleted",
  "result_code": "Success",
  "tx_additional_data_json": "{\"Message\":{\"TenantId\":7193628450192736815,\"TenantCode\":\"SPYDM\",\"SenderName\":null,\"SenderIban\":null,\"ReceiverBankCode\":null,\"ReceiverBankName\":null,\"ReceiverIban\":null,\"Amount\":10000.0,\"CurrencyCode\":\"TRY\",\"Description\":\"baris123\",\"TransactionType\":null,\"RegexDefinitionResultData\":\"baris123\",\"BankTransactionDate\":\"2022-08-08T08:11:26.899Z\",\"BankReceiptNo\":\"24343113443433315334336\",\"NationalIdOrTaxNo\":\"21374183526\",\"NationalIdHashed\":null,\"IbanHashed\":null,\"SourceType\":null,\"ChannelType\":null,\"AccountType\":null,\"WalletNumber\":null},\"BalanceChanges\":{\"Sender\":{\"Before\":null,\"After\":null},\"Receiver\":{\"Before\":{\"PaymentAvailable\":0.00,\"PaymentUnavailable\":0.00,\"CashAvailable\":759386.32,\"CashUnavailable\":1517.25},\"After\":{\"PaymentAvailable\":0.00,\"PaymentUnavailable\":0.00,\"CashAvailable\":769386.320000,\"CashUnavailable\":1517.25}}},\"AccountInfo\":{\"Sender\":null,\"Receiver\":{\"FullName\":\"BARIŞ TOPER\",\"AccountId\":\"6032924232594877453\",\"AccountNumber\":\"baris123\",\"WalletNumber\":\"754938444\",\"AccountTypeId\":\"1\",\"KycLevelCode\":\"40\",\"GroupCode\":null}}}",
  "created_date_utc": "2025-07-22T06:59:49.1256809Z",
  "updated_date_utc": "2025-07-22T06:59:49.1256809Z",
  "completed_date_utc": "2025-07-22T06:59:49.4254086Z",
  "financial_process_completed_date_utc": null,
  "is_financial_process_completed": false,
  "to_wallet_id": 7546260134048689165,
  "tx_base_amount": 10000,
  "tx_additional_fee": 0,
  "tx_amount_with_additional_fee": 10000,
  "currency_code": "TRY",
  "tx_end_user_preview_json": "",
  "tx_pre_financial_acquired_record_json": null,
  "tx_financial_acquired_record_json": "{\r\n  \"Id\": 981307,\r\n  \"TenantId\": 5,\r\n  \"TxCorrelationId\": 2507225317817012915,\r\n  \"TxSenderWalletId\": 7546260134048689165,\r\n  \"TxReceiverWalletId\": 0,\r\n  \"CommissionTypeLevel\": 3,\r\n  \"Currency\": \"TRY\",\r\n  \"TransactionType\": \"TPFBNK_PERSONAL\",\r\n  \"TransactionBaseAmount\": 10000.00,\r\n  \"CommissionRateAmount\": 0.0000,\r\n  \"CommissionFixedAmount\": 0.0000,\r\n  \"IsNeedSettlement\": true,\r\n  \"SettlementHour\": 0,\r\n  \"SettlementDay\": 0,\r\n  \"IsCancelled\": false,\r\n  \"IsFinancialProcessCompleted\": false,\r\n  \"AutoSettlement\": false,\r\n  \"CreatedDateUtc\": \"2025-07-22T06:59:49.1266667+00:00\",\r\n  \"CancelDateUtc\": null\r\n}",
  "from_description": "BANKA HESABI",
  "to_description": "BARIŞ TOPER",
  "tx_description": "baris123",
  "kyc_level_id": 40,
  "from_account_type_id": 0,
  "from_account_id": 0,
  "from_wallet_number": "",
  "from_account_number": "",
  "to_account_number": "baris123",
  "to_account_type_id": 1,
  "to_account_id": 6032924232594877453,
  "to_wallet_number": "754938444",
  "is_need_settlement": true,
  "settlement_day": 0,
  "ext_transaction_id": "24343113443433315334336",
  "from_user_kyc_info": null,
  "to_user_kyc_info": null,
  "source_type": null,
  "channel_type": null,
  "media_identifier": null,
  "terminal_no": null,
  "media_type": "",
  "provider_id": null,
  "to_account_tx_base_amount": 10000,
  "to_account_tx_additional_fee": 0,
  "to_account_tx_amount_with_additional_fee": 10000,
  "from_ext_account_number": null,
  "to_ext_account_number": null,
  "from_group_code": null,
  "to_group_code": null,
  "receipt_number": "SPYDM_250000163606",
  "ip_address": "::1",
  "client_port": ""
}

If a successful top-up is made with a business account, the following webhook body is sent:

{
  "id": 2507286963749015584,
  "tenant_id": 5,
  "tx_group_correlation_id": 0,
  "tx_ref_correlation_id": 0,
  "wallet_id": 2506263092567938281,
  "transaction_type_id": 1004,
  "transaction_type": "Topup Bank Transfer | IsCashinTx = true",
  "transaction_status_id": 20,
  "transaction_status": "NormalCompleted",
  "result_code": "Success",
  "tx_additional_data_json": "{\"Message\":{\"TenantId\":5,\"TenantCode\":\"SPYDM\",\"SenderName\":null,\"SenderIban\":null,\"ReceiverBankCode\":null,\"ReceiverBankName\":null,\"ReceiverIban\":null,\"Amount\":10000.0,\"CurrencyCode\":\"TRY\",\"Description\":\"2157300503\",\"TransactionType\":null,\"RegexDefinitionResultData\":\"2157300503\",\"BankTransactionDate\":\"2022-08-08T08:11:26.899Z\",\"BankReceiptNo\":\"2434311334434333115334336\",\"NationalIdOrTaxNo\":\"0652373016\",\"NationalIdHashed\":null,\"IbanHashed\":null,\"SourceType\":null,\"ChannelType\":null,\"AccountType\":null,\"WalletNumber\":null},\"BalanceChanges\":{\"Sender\":{\"Before\":null,\"After\":null},\"Receiver\":{\"Before\":{\"PaymentAvailable\":3000.00,\"PaymentUnavailable\":2000.00,\"CashAvailable\":40461.00,\"CashUnavailable\":0.00},\"After\":{\"PaymentAvailable\":3000.00,\"PaymentUnavailable\":2000.00,\"CashAvailable\":50461.000000,\"CashUnavailable\":0.00}}},\"AccountInfo\":{\"Sender\":null,\"Receiver\":{\"FullName\":\"UPRİŞĞ\",\"AccountId\":\"2506268645230974659\",\"AccountNumber\":\"2157300503\",\"WalletNumber\":\"582434260\",\"AccountTypeId\":\"2\",\"KycLevelCode\":\"40\",\"GroupCode\":null}}}",
  "created_date_utc": "2025-07-28T10:37:14.3938846Z",
  "updated_date_utc": "2025-07-28T10:37:14.3938846Z",
  "completed_date_utc": "2025-07-28T10:37:14.4869598Z",
  "financial_process_completed_date_utc": null,
  "is_financial_process_completed": false,
  "to_wallet_id": 2506263092567938281,
  "tx_base_amount": 10000,
  "tx_additional_fee": 0,
  "tx_amount_with_additional_fee": 10000,
  "currency_code": "TRY",
  "tx_end_user_preview_json": "",
  "tx_pre_financial_acquired_record_json": null,
  "tx_financial_acquired_record_json": null,
  "from_description": "BANKA HESABI",
  "to_description": "UPRİŞĞ",
  "tx_description": "2157300503",
  "kyc_level_id": 40,
  "from_account_type_id": 0,
  "from_account_id": 0,
  "from_wallet_number": "",
  "from_account_number": "",
  "to_account_number": "2157300503",
  "to_account_type_id": 2,
  "to_account_id": 2506268645230974659,
  "to_wallet_number": "582434260",
  "is_need_settlement": true,
  "settlement_day": 0,
  "ext_transaction_id": "2434311334434333115334336",
  "from_user_kyc_info": null,
  "to_user_kyc_info": null,
  "source_type": null,
  "channel_type": null,
  "media_identifier": null,
  "terminal_no": null,
  "media_type": "",
  "provider_id": null,
  "to_account_tx_base_amount": 10000,
  "to_account_tx_additional_fee": 0,
  "to_account_tx_amount_with_additional_fee": 10000,
  "from_ext_account_number": null,
  "to_ext_account_number": null,
  "from_group_code": null,
  "to_group_code": null,
  "receipt_number": "SPYDM_250000170884",
  "ip_address": "::1",
  "client_port": ""
}

❌ Failed Top-up Webhooks

1. Wallet Not Found

{
"tenant_id": 7193628450192736815,
"result_message": "Cüzdan bulunamadı! Created request topup cash. Regex Data: 8473940087 NationalId Or Tax No: 11111111111",
"result_code": "300",
"wallet_number": "",
"description": "8473940087",
"amount": 10000,
"currency_code": "TRY"
}

2. Insufficient Wallet Limit

{
"tenant_id": 7193628450192736815,
"result_message": "Üyelik seviyenize tanımlanmış olan limit, işlemi gerçekleştirebilmeniz için yeterli değildir. Kullanılabilir Limit: 7234,00 TRY",
"result_code": "310",
"wallet_number": "1234567890",
"amount": 10000,
"currency_code": "TRY"
}

3. Duplicate Attempt with the Same Transaction ID

{
"tenant_id": 7193628450192736815,
"result_message": "Dekont numarası(243432323434334343314434336) ile daha önce topup/deposit yapılmış!",
"result_code": "360",
"wallet_number": "1234567890",
"amount": 10000,
"currency_code": "TRY"
}

4. KYC10 Limit Exceeded

{
"tenant_id": 7193628450192736815,
"result_message": "Something went wrong with getting simulated balance movements! TenantId:7193628450192736815, Transaction Type: TPFBNK_PERSONAL, KYCLevel: Unknown, Currency: TRY, Amount: 10000,0",
"result_code": "361",
"wallet_number": "1234567890",
"amount": 10000,
"currency_code": "TRY"
}

📌 Important Notes

All webhooks are sent asynchronously.

To confirm the actual transaction result, the GetRequestTopupCashByExtId or SummaryRecordByFilter services should be used.

✅ Successful Top-up Webhook#

❌ Failed Top-up Webhooks#

1. Wallet Not Found#

2. Insufficient Wallet Limit#

3. Duplicate Attempt with the Same Transaction ID#

4. KYC10 Limit Exceeded#