Native Bank List

Native API üzerinden kullanılabilir banka ve banka hesaplarını listeler.

Bu endpoint, siteye tanımlı aktif banka hesaplarını döndürür. Dönen hesaplar yatırım aralığı, günlük limit, işlem limiti ve toplam limit kontrollerine göre değerlendirilir.

Base URL

https://new.galaxypay.dev

Endpoint

POST /payment/native/banks

Full URL

https://new.galaxypay.dev/payment/native/banks

Headers

Header	Zorunlu	Açıklama
Content-Type	Evet	application/json
Accept	Evet	application/json

Request Parameters

Parametre	Zorunlu	Tip	Açıklama
api_id	Evet	integer	Siteye ait API ID
api_key	Evet	string	Siteye ait API Key
lang	Hayır	string	Dil kodu. `tr` veya `en`
currency	Hayır	string	Para birimi. `TRY`, `USD`, `EUR`

Example Request

{
  "api_id": 621,
  "api_key": "SITE_API_KEY",
  "lang": "tr",
  "currency": "TRY"
}

cURL Example

curl --location 'https://new.galaxypay.dev/payment/native/banks' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
  "api_id": 621,
  "api_key": "SITE_API_KEY",
  "lang": "tr",
  "currency": "TRY"
}'

Success Response

{
  "code": 200,
  "type": "success",
  "message": "Talebiniz Alınmıştır.",
  "site_id": 621,
  "banks": [
    {
      "id": 9,
      "name": "Ziraat Bankası",
      "available_account_count": 3,
      "total_account_count": 3,
      "accounts": [
        {
          "bank_account_id": 532,
          "bank_id": 9,
          "account_owner": "AHMET AKÇARA",
          "iban": "TR720001009010623120505015",
          "account_number": "998998989",
          "branch_code": "778768",
          "deposit_range": {
            "id": 81,
            "min": 5001,
            "max": 10000
          },
          "limits": {
            "process_limit": 10,
            "process_used": 2,
            "process_remaining": 8,
            "daily_limit": 100000,
            "daily_used": 25000,
            "daily_remaining": 75000,
            "total_limit": 500000,
            "total_used": 120000,
            "total_remaining": 380000,
            "pending_amount": 10000
          },
          "is_available": true,
          "unavailable_reason": null,
          "status": 1
        }
      ]
    }
  ]
}

Response Fields

Main Response

Alan	Tip	Açıklama
code	integer	İşlem durum kodu
type	string	`success` veya `error`
message	string	İşlem mesajı
site_id	integer	API isteği yapılan site ID
banks	array	Banka listesi

Bank Object

Alan	Tip	Açıklama
id	integer	Banka ID
name	string	Banka adı
available_account_count	integer	Kullanılabilir hesap sayısı
total_account_count	integer	Toplam hesap sayısı
accounts	array	Bankaya ait hesap listesi

Account Object

Alan	Tip	Açıklama
bank_account_id	integer	Banka hesap ID
bank_id	integer	Banka ID
account_owner	string	Hesap sahibi
iban	string/null	IBAN bilgisi
account_number	string/null	Hesap numarası
branch_code	string/null	Şube kodu
deposit_range	object/null	Hesaba ait yatırım aralığı
limits	object	Hesap limit bilgileri
is_available	boolean	Hesabın işlem için uygun olup olmadığı
unavailable_reason	string/null	Hesap uygun değilse sebebi
status	integer	Hesap durum bilgisi

Deposit Range Object

Alan	Tip	Açıklama
id	integer	Yatırım aralığı ID
min	numeric	Minimum yatırım tutarı
max	numeric	Maksimum yatırım tutarı

Limits Object

Alan	Tip	Açıklama
process_limit	numeric/null	Hesabın işlem adedi limiti
process_used	numeric	Kullanılan işlem adedi
process_remaining	numeric/null	Kalan işlem adedi
daily_limit	numeric/null	Günlük tutar limiti
daily_used	numeric	Günlük kullanılan tutar
daily_remaining	numeric/null	Günlük kalan tutar
total_limit	numeric/null	Toplam tutar limiti
total_used	numeric	Toplam kullanılan tutar
total_remaining	numeric/null	Toplam kalan tutar
pending_amount	numeric	Bekleyen işlem toplamı

Error Response - Validation Error

{
  "code": 1001,
  "type": "error",
  "message": "Geçersiz istek.",
  "errors": {
    "api_id": [
      "API ID alanı zorunludur."
    ],
    "api_key": [
      "API Key alanı zorunludur."
    ]
  }
}

Error Response - Invalid API Credentials

{
  "code": 1002,
  "type": "error",
  "message": "API bilgileri hatalı."
}

Error Response - Site Not Found

{
  "code": 1003,
  "type": "error",
  "message": "Site bulunamadı."
}

Error Response - No Available Bank Account

{
  "code": 1013,
  "type": "error",
  "message": "Bu API için kullanılabilir banka hesabı bulunamadı.",
  "site_id": 621,
  "banks": []
}

Notes

Bu endpoint sadece banka ve hesap listesini döndürür, işlem oluşturmaz.
Yatırım işlemi oluşturmak için `Native Deposit` endpointi kullanılmalıdır.
`bank_account_id` değeri, yatırım oluşturma isteğinde opsiyonel olarak gönderilebilir.
`is_available` değeri `false` olan hesaplar işlem için uygun değildir.
`available_account_count`, sadece uygun hesapların toplamını gösterir.
`total_account_count`, bankaya bağlı tüm hesapların toplamını gösterir.
Limitler sistemde tanımlı değilse ilgili alanlar `null` dönebilir.
`pending_amount`, henüz sonuçlanmamış yatırım taleplerinden gelen bekleyen toplam tutarı ifade eder.