Sipay Business Api
English
  • Turkish
  • English
  1. Overview
Sipay Business Api
English
  • Turkish
  • English
  • Overview
    • Partner Wallet Flow Guide
    • Sipay Business API
  • 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 Wallet Flow Guide

Partner Wallet Integration – Flow Guide (Sipay Business API)#

🎯 Partner Wallet Concept#

Sipay Business API allows third-party fintech partners to integrate their wallet systems and securely interact with business wallets for fund transfers and account management.

🔧 Integration Requirements#

1.
Sipay must create a business account and at least one corporate wallet on behalf of the partner.
2.
The partner must request the client_credentials, client_id, and client_secret values from Sipay to perform authentication.

🔄 Incoming Funds Flow (Partner → Sipay Wallet)#

Step-by-Step:#

1.
Partner creates an internal payment transaction initiated by the user.
2.
Partner sends funds to Sipay wallet using internal logic.
3.
Sipay uses /v1/Wallet/ListByFilter to validate funds have arrived in the relevant wallet.
4.
Partner notifies Sipay via webhook or callback (optional) to confirm funds are sent.
5.
Once confirmed, transaction is marked as completed in both systems.

🔁 Outgoing Funds Flow (Sipay Wallet → Partner User)#

Step-by-Step:#

1.
Partner requests a payout to one of its users.
2.
Sipay initiates a transfer using either:
/v1/Transaction/BusinessToPersonalTransfer
/v1/Transaction/SendMoneyToBankAccount
3.
Once the transfer is successful, the transaction is marked as completed.
4.
Partner receives status update or calls SummaryRecordByFilter to verify.

📘 Notes for Implementation#

All transfers require a unique ext_transaction_id.
Transfers are executed in TRY.
Each wallet has its own limits, available via /v1/Wallet/Info.
Partner is responsible for pre-validating recipient wallets using /v1/Account/CheckPersonalWallet.
Errors and edge cases should be handled using standardized response codes (e.g. 311, 306).
For full endpoint reference and parameters, refer to the API Reference Documentation.
Next
Sipay Business API
Built with