Sipay Wallet Api
  1. Webhook
Sipay Wallet Api
  • Overview
    • Sipay Business API
    • Partner Wallet Flow Guide
  • Authentication
    • Get Access Token
      POST
  • Account
    • PersonalAccount
      • Register Personal Account
      • Get Personal Account
      • Check Personal Wallet (AccountNumber)
      • Check Personal Wallet (PhoneNumber)
      • Submit KYC Form
      • Personal List By Filter
      • Update Personal Account
      • Get Personal Bank Account List By Filter
    • BusinessAccount
      • Register Business Account
      • Get Business Account
      • Business List By Filter
      • Check Business Wallet
      • Business Account Submit KYC Form
      • Update Business Account
      • Get Business Bank Account List By Filter
      • Create Business Bank Account
      • Update Business Bank Account
    • PersonalAccount & BusinessAccount
      • Account Balance Inquiry
      • Get KYC Detail
      • Tenant Bank List By Filter
  • Digital KYC
    • Status
      POST
    • Get Identity Info
      POST
    • Verify Address
      POST
    • Submit Digital KYC Additional Fields
      POST
    • Completed Digital KYC
      POST
  • Wallet
    • Create Wallet For Business Account
      POST
    • Create Wallet For Personal Account
      POST
    • Wallet Info
      POST
    • Wallet List By Filter
      POST
  • Transaction
    • Topup Credit Card
      • Topup Credit Card
      • Request Refund Topup Credit
    • Wallet To Wallet Transfer
      • Personal To Personal Transfer
      • Personal To Business Transfer
      • Business To Personal Transfer
      • Business To Business Transfer
      • Transfer To Virement
    • Withdraw To Bank
      • Withdrawal To Bank Instant
      • Send Money To Bank Account
    • Payment
      • Payment
      • Refund Payment Instant
    • Cashback
      • Cashback
      • Cashback Credit
    • TR QR Code
      • Read TR QR Code
      • Start TR QR Code
      • Get TR QR Code
    • QR Personal To Personal
      • Create QR Personal To Personal Transfer
      • Read QR Personal To Personal Transfer
      • Check QR Personal To Personal Transfer
      • Approve QR Personal To Personal Transfer
    • QR Payment
      • Create QR Payment
      • Read QR Payment
      • Check QR Payment Status
      • Approve QR Payment
  • Loyalty
    • Add Loyalty Program
    • Increase Loyalty Balance
    • Decrease Loyalty Balance
    • Loyalty Payment
  • Card Package
    • Virtual Card
      • Create Card
      • Get Card Info
    • Physical Card
      • Create Prepaid Card
      • Get Card Last Courier Activity
      • Set Card Active and Set Pin
      • Personalize Noname Prepaid Card
      • Validation For Expire Date and Cvv
    • Virtual Card & Physical Card
      • Get Payment Provider Media List By Filter
      • Set Card Pin
      • Update Card Pin
      • Set Card Random Pin
      • Set Card Mobile Phone
      • Set Card Limit and Restriction
      • Get Card Limit and Restriction
      • Set Card As Active
      • Set Card As Passive
      • Set Card As Lost
      • Close Card As Stolen
      • Close Card Permanently
      • Create Card Inquiry
      • Card Transaction Failed List
  • Metropol Kart Entegrasyonu
    • Add Provider Media To Wallet
    • Create 3rd Party QR Code
    • Begin 3rd Party QR Code Payment
    • Complete 3rd Party QR Code Payment
  • Invoice Payment
    • Get Cities
    • Get Product Types
    • Get Products By City And Type
    • Get Product Detail By Product ID
    • Get Invoices By Product And Subscriber
    • Make Payment
  • Transaction Data
    • Summary Record By Filter
    • Get Request Withdraw List By Filter
    • Get Request Withdraw By Ext Id
    • Transaction Receipt
  • Static Data
    • Get Province City List
    • Get City List By Province ID
    • Get Job List
    • Get Country List
  • Webhook
    • Bankaya Para Transferi Webhook
    • Para Yükleme Webhook
    • Kart Statü Değişimleri Webhook
    • Hesap Statü Değişimleri Webhook
    • KYC Statü Değişimleri Webhook
    • KYC 20 Statü Webhook
    • Dijital KYC Webhook
    • Hesap Bilgileri Değişimi Webhook
    • Kartlı Ödemeler ve İadeleri Webhook
    • Cashback Webhook
    • Cüzdanlar Arası Para Transferi Webhook
  • Webhook EN
    • Bank Transfer Webhook
    • Top-up Webhook
    • Card Status Change Webhook
    • Account Status Change Webhook
    • KYC Status Change Webhook
    • KYC 20 Status Webhook
    • Digital KYC Webhook
    • Account Information Change Webhook
    • Card Payments and Refunds Webhook
    • Cashback Webhook
    • Wallet to Wallet Transfer Webhook
  1. Webhook

Para Yükleme Webhook

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

Bireysel hesap ile başarılı para yüklemesi yapılırsa aşağıdaki webhook bodysi gönderilir:
{
  "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": ""
}
İşletme hesabı ile başarılı para yüklemesi yapılırsa aşağıdaki webhook bodysi gönderilir:
{
  "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": 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. Cüzdan Limiti Yetersiz#
{
"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. Aynı İşlem Numarası ile Tekrar Deneme#
{
"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 Limiti Aşıldı#
{
"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"
}

📌 Ö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.
Modified at 2025-07-28 10:37:55
Previous
Bankaya Para Transferi Webhook
Next
Kart Statü Değişimleri Webhook
Built with