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

Bankaya Para Transferi Webhook

✅ Başarılı İşlem Sonrası Webhook#
Eğer /v1/Transaction/SendMoneyToBankAccount servisi başarılı yanıt dönerse ve işlem banka tarafından da başarıyla gerçekleşirse aşağıdaki gibi bir webhook gönderimi yapılır:
{
"tenant_id": 7193628450192736815,
"amount": 50,
"currency_code": "TRY",
"ext_transaction_id": "54171323223317131311333332552",
"request_withdraw_id": 2505267108142371608,
"transaction_id": 2505266701488343592,
"account_type_id": 2,
"account_number": "12345678",
"wallet_number": "23456789",
"before_process_status": 1,
"after_process_status": 1,
"money_transfer_state": 0,
"money_transfer_type": 3,
"to_iban": "TR000000000000000000000000",
"response_status": 2,
"response_code": "312",
"response_message": "Bu işlem daha önce başarıyla gerçekleştirilmiştir.",
"transaction_type": "A01",
"to_name": "Fxxxx",
"reason": "Basarili"
}
after_process_status = 1 ve transaction_id > 0 → İşlem başarıyla tamamlanmış demektir.
Ancak nadiren, bankadan iade durumu oluşabilir. Bu durumda aynı işlem için:
after_process_status = 5 ile webhook gönderilir. Bu iade işlemidir, başarısızlık değildir.
❌ Başarısız İşlem Senaryoları#
1.
API Çağrısı Başarısızsa:
Servis response’u hata ile dönerse (ör. bakiye yetersizliği), webhook gönderilmez.
Örnek hata:
{ "status": 2, "code": "311", "message": "Cüzdan bakiyeniz yetersiz olduğundan işlemi gerçekleştiremiyoruz" }
2.
API Çağrısı Başarılı ama İşlem Bankada Reddedilirse:
Bu durumda after_process_status = 2 veya 4 olur.
Webhook gönderilir, ancak işlem durumu “başarısız” olarak değerlendirilir:
{
"tenant_id": 7193628450192736815,
"amount": 50,
"currency_code": "TRY",
"ext_transaction_id": "54171323223317131311333332552",
"request_withdraw_id": 2505267108142371608,
"transaction_id": 2505266701488343592,
"account_type_id": 2,
"account_number": "12345678",
"wallet_number": "23456789",
"before_process_status": 1,
"after_process_status": 2,
"money_transfer_state": 0,
"money_transfer_type": 3,
"to_iban": "TR000000000000000000000000",
"response_status": 2,
"response_code": "312",
"response_message": "Bu işlem daha önce başarıyla gerçekleştirilmiştir.",
"transaction_type": "A01",
"to_name": "Fxxx",
"reason": "Basarili"
}
⚠️ Manuel Onay Süreci (Operasyonel Durum)#
Eğer işlem manuel operasyona düşerse, webhook gönderimi yapılmaz.
after_process_status = 3 olur.
Operasyon ekibi manuel onaylar; işlem takibi için ext_transaction_id ile GetRequestWithdrawByExtId servisine istek atılmalıdır.
Bu durum genellikle IBAN, ad-soyad uyumsuzluğu gibi manuel müdahale gerektiren senaryolarda görülür.
📌 Önemli Notlar#
Webhook’lar her durumda asenkron gönderilir.
Mutlak güvence için işlem durumu ayrıca GetRequestWithdrawByExtId servisinden kontrol edilmelidir.
Modified at 2025-07-24 12:46:24
Previous
Get Country List
Next
Para Yükleme Webhook
Built with