Sipay Business Api
Turkish
  • Turkish
  • English
  1. Overview
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. Overview

Hızlı Başlangıç Rehberi

Sipay Business API; işletmelere ait cüzdanlar üzerinden para transferi, hesap yönetimi ve işlem takibi yapılmasını sağlayan RESTful servislerden oluşur. Aşağıdaki rehber, ilk entegrasyonu gerçekleştirmek isteyen ekipler için hazırlanmıştır.

✅ 1. Kimlik Doğrulama (Token Alma)#

Tüm işlemlerden önce access token alınmalıdır.
Token endpoint ve parametre bilgisi sol menüde Authentication başlığında yer almaktadır.
Token alma işlemi 'https://idsuat.walletgate.io' adresinden yapılır, tüm API işlemleri ise 'https://stsapiuat.walletgate.io' üzerinden gerçekleştirilir.
Canlı ortam kurulumuna geçildiğinde, domain bilgileri paylaşılmaktadır.

💼 2. Hesap ve Cüzdan Tanımlama#

Kurumsal hesabınızı sorgulayın
En az bir işletme cüzdanı oluşturun
Mevcut cüzdanların bilgilerini alın
Detaylı kullanım için sol menüdeki Account & Wallet başlığına bakabilirsiniz.

💸 3. Para Transferi Başlatma#

Kullanım senaryonuza göre aşağıdaki servislerden birini seçin:
IBAN’a gönderim
Kurumsaldan bireysele transfer
Kurumsaldan kurumsala transfer
Kurumsal hesaplarda diğer cüzdanlar arası transfer
Detaylı kullanım için: Transaction menüsü

🔍 4. İşlem Takibi ve Dekont#

Gerçekleşen işlemleri filtreleyerek listeleyin
İşlem detaylarını ve dekont bilgilerini görüntüleyin
Detaylı kullanım için: Transaction Data menüsü

⚠️ Önemli Notlar#

ext_transaction_id her işlemde benzersiz olmalıdır.
Tüm işlemler TRY para birimi ile gerçekleştirilmelidir.
Sipay tarafında siz her zaman gönderici (sender) konumundasınız.
Cüzdan limit bilgisi /Wallet/Info ile alınabilir.
Hatalar response içinde status, code ve message alanlarında iletilir.

🧪 Entegrasyon Akışı (Önerilen Sıralama)#

1.
✅ Token alın
2.
🧾 Hesap ve cüzdan bilgilerini kontrol edin
3.
💸 Transfer işlemi başlatın
4.
🔍 İşlem sonucunu sorgulayın
5.
📄 Gerekirse dekont alın
Next
Partner Cüzdan Entegrasyonu
Built with