Sipay Business Api
Turkish
  • Turkish
  • English
  1. Genel Bakış
Sipay Business Api
Turkish
  • Turkish
  • English
  • Genel Bakış
    • Hızlı Başlangıç Rehberi
    • Partner Cüzdan Entegrasyonu
  • Authentication
    • Get Access Token
      POST
  • Account
    • Get Business Account
      POST
    • Update Business Account
      POST
    • Check Personal Wallet
      POST
  • Wallet
    • Create Wallet For Business Account
      POST
    • Wallet Info
      POST
    • Wallet List By Filter
      POST
  • Transaction
    • Business To Business Transfer
      POST
    • Send Money To Bank Account
      POST
    • Transfer To Virement
      POST
    • Business To Personal Transfer
      POST
  • Transaction Data
    • Summary Record By Filter
      POST
    • Get Withdraw Request By External ID
      POST
    • Get Request Withdraw List By Filter
      POST
    • Transaction Receipt
      POST
  1. Genel Bakış

Partner Cüzdan Entegrasyonu

🎯 Partner Cüzdan Yapısı#

Sipay Business API, fintech partnerlerin kendi cüzdan sistemlerini entegre ederek Sipay işletme cüzdanlarıyla güvenli şekilde işlem yapmalarını sağlar.

🔧 Entegrasyon Gereklilikleri#

1.
Sipay, partner adına bir işletme hesabı ve en az bir kurumsal cüzdan oluşturmalıdır.
2.
Partner, kimlik doğrulama işlemleri için gerekli olan client_credentials, client_id ve client_secret bilgilerini Sipay'den talep etmelidir.

🔄 Gelen Para Akışı (Partner → Sipay Cüzdanı)#

İşleyiş:#

1.
Partner, kullanıcının başlattığı bir ödeme işlemi oluşturur.
2.
Partner, fonu kendi sisteminden Sipay’deki kurumsal cüzdana iletir.
3.
Sipay, /v1/Wallet/ListByFilter servisiyle fonun ilgili cüzdana ulaştığını kontrol eder.
4.
Partner, (varsa) callback ya da webhook ile transferi doğrular.
5.
İşlem, her iki sistemde de "tamamlandı" olarak işaretlenir.

🔁 Giden Para Akışı (Sipay Cüzdanı → Partner Kullanıcısı)#

İşleyiş:#

1.
Partner, kendi sisteminde bir kullanıcı için ödeme talebi oluşturur.
2.
Sipay, aşağıdaki servislerden biri ile transferi başlatır:
/v1/Transaction/BusinessToPersonalTransfer
/v1/Transaction/SendMoneyToBankAccount
3.
Transfer başarılı olduğunda, işlem tamamlandı olarak işaretlenir.
4.
Partner, işlem durumu için webhook alır ya da SummaryRecordByFilter servisi ile sorgulama yapar.

📘 Uygulama Notları#

Tüm transferlerde benzersiz ext_transaction_id kullanılmalıdır.
İşlemler sadece TRY para birimiyle gerçekleştirilmelidir.
Her cüzdanın bakiyesi ve limiti /v1/Wallet/Info ile öğrenilebilir.
Alıcı cüzdan bilgisi, işlem öncesi /v1/Account/CheckPersonalWallet servisiyle doğrulanmalıdır.
Hatalar standart kodlarla döner (örn. 311, 306).
Previous
Hızlı Başlangıç Rehberi
Next
Get Access Token
Built with