Sipay Business Api
Turkish
  • Turkish
  • English
  1. Webhook
Sipay Business Api
Turkish
  • Turkish
  • English
  • Overview
    • Hızlı Başlangıç Rehberi
    • Partner Cüzdan Entegrasyonu
  • Authentication
    • Get Access Token
      POST
  • Account
    • Get Business Account
      POST
    • Check Personal Wallet (AccountNumber)
      POST
    • Check Personal Wallet (PhoneNumber)
      POST
  • Wallet
    • Create Wallet For Business Account
      POST
    • Wallet Info
      POST
    • Wallet List By Filter
      POST
  • Transaction
    • Business To Personal Transfer
      POST
    • Business To Business Transfer
      POST
    • Send Money To Bank Account
      POST
    • Transfer To Virement
      POST
  • Transaction Data
    • Summary Record By Filter
      POST
    • Get Request Withdraw List By Filter
      POST
    • Get Request Withdraw By Ext Id
      POST
    • Transaction Receipt
      POST
  • Webhook
    • Bankaya Para Transferi Webhook
    • Para Yükleme Webhook
  1. Webhook

Para Yükleme Webhook

✅ Başarılı Para Yükleme Webhook'u#

Başarılı para yüklemesi yapılırsa aşağıdaki webhook bodysi gelir:
{
  "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": ""
}

❌ Başarısız Para Yükleme Webhook'ları#

1. Cüzdan Bulunamadı#
{
"tenant_id": 5,
"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. Cüzdan Limiti Yetersiz#
{
"tenant_id": 5,
"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. Aynı İşlem Numarası ile Tekrar Deneme#
{
"tenant_id": 5,
"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 Limiti Aşıldı#
{
"tenant_id": 5,
"result_message": "Something went wrong with getting simulated balance movements! TenantId:5, Transaction Type: TPFBNK_PERSONAL, KYCLevel: Unknown, Currency: TRY, Amount: 10000,0",
"result_code": "361",
"wallet_number": "1234567890",
"amount": 10000,
"currency_code": "TRY"
}

📌 Önemli Notlar#

Tüm webhooklar asenkron olarak gönderilir.
Gerçek işlem sonucunun teyidi için GetRequestTopupCashByExtId veya SummaryRecordByFilter servisleri kullanılmalıdır.
Previous
Bankaya Para Transferi Webhook
Built with