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

Partner Cüzdan Entegrasyonu

🎯 Partner Cüzdan Yapısı#

Sipay Business API, fintech partnerlerin kendi cüzdan sistemlerini Sipay altyapısıyla entegre ederek güvenli, denetlenebilir ve sürdürülebilir bir işlem akışı kurmalarını sağlar.

🔧 Entegrasyon Gereklilikleri#

1.
Sipay, partner adına bir işletme hesabı ve en az bir adet kurumsal cüzdan oluşturur.
2.
Partner, kimlik doğrulama işlemleri için gerekli client_credentials, client_id ve client_secret bilgilerini Sipay’den temin eder.

🔁 Sipay Cüzdanından Kullanıcıya veya Banka Hesabına Ödeme#

(Ödeme Dağıtım Süreci)#

İşleyiş:#

1.
Partner, kendi sisteminde bir kullanıcı için ödeme talebi oluşturur ve işlemi başlatmak üzere Sipay API’sine çağrı gönderir.
2.
Sipay, aşağıdaki servislerden uygun olanı kullanarak transferi gerçekleştirir:
/v1/Transaction/BusinessToPersonalTransfer
/v1/Transaction/SendMoneyToBankAccount
3.
Transfer başarıyla gerçekleştiğinde, işlem sistemde "tamamlandı" olarak işaretlenir.
4.
Partner, işlem sonucunu aşağıdaki yöntemlerden biriyle takip eder:
SummaryRecordByFilter servisiyle sorgulama
(varsa) tanımlı webhook bildirimi aracılığıyla anlık işlem durumu alma

📘 Uygulama Notları#

Her transfer için benzersiz bir ext_transaction_id kullanılması zorunludur.
İşlemler yalnızca TRY para birimi ile yapılabilir.
Partner, cüzdan bakiyesi ve limitini /v1/Wallet/Info servisi üzerinden kontrol edebilir.
Hatalar standart hata kodlarıyla döner (örnek: 311 – "Cüzdan bulunamadı", 503 – "Geçersiz parametre").
Previous
Hızlı Başlangıç Rehberi
Next
Get Access Token
Built with