E-Pos alış oranlarını oku

{
  "status": true,
  "result": {
    "accountId": "600000000000000000000001",
    "revision": 3,
    "fetchedAt": "2026-10-25T09:00:00.000Z",
    "rates": [
      {
        "family": "paraf",
        "installment": 1,
        "purchaseRate": 1.49
      },
      {
        "family": "paraf",
        "installment": 3,
        "purchaseRate": 4.8
      }
    ]
  }
}

{
  "status": false,
  "code": "BANKPOS_INVALID_REQUEST",
  "message": "İstek alanları geçersiz."
}

{
  "status": false,
  "code": "UNAUTHORIZED",
  "message": "API kimlik bilgileri doğrulanamadı."
}

{
  "status": false,
  "message": "Ürün, IP, modül izni veya kaynak kapsamı uygun değil."
}

{
  "status": false
}

{
  "status": false,
  "code": "BANKPOS_REVISION_CONFLICT",
  "message": "Güncel hesap veya tercih sürümünü okuyun."
}

{
  "status": false,
  "code": "BANKPOS_RATES_UNSUPPORTED",
  "message": "Sağlayıcının oran listeleme desteğini kontrol edin."
}

{
  "status": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please try again later."
}

{
  "status": false,
  "code": "INTERNAL_ERROR",
  "message": "İşlem gerçekleştirilemedi."
}

{
  "status": false,
  "code": "BANKPOS_RATES_UNAVAILABLE",
  "message": "Geçersiz veya eksik katalog cevabını sıfır oran saymayın."
}

{
  "status": false,
  "code": "BANKPOS_BRIDGE_UNAVAILABLE",
  "message": "Bağlantı şu anda kullanılamıyor; mali isteği otomatik tekrarlamayın."
}

GET

https://api.muhasip.pro

apps

bankpos

accounts

{accountId}

installment-rates

{
  "status": true,
  "result": {
    "accountId": "600000000000000000000001",
    "revision": 3,
    "fetchedAt": "2026-10-25T09:00:00.000Z",
    "rates": [
      {
        "family": "paraf",
        "installment": 1,
        "purchaseRate": 1.49
      },
      {
        "family": "paraf",
        "installment": 3,
        "purchaseRate": 4.8
      }
    ]
  }
}

{
  "status": false,
  "code": "BANKPOS_INVALID_REQUEST",
  "message": "İstek alanları geçersiz."
}

{
  "status": false,
  "code": "UNAUTHORIZED",
  "message": "API kimlik bilgileri doğrulanamadı."
}

{
  "status": false,
  "message": "Ürün, IP, modül izni veya kaynak kapsamı uygun değil."
}

{
  "status": false
}

{
  "status": false,
  "code": "BANKPOS_REVISION_CONFLICT",
  "message": "Güncel hesap veya tercih sürümünü okuyun."
}

{
  "status": false,
  "code": "BANKPOS_RATES_UNSUPPORTED",
  "message": "Sağlayıcının oran listeleme desteğini kontrol edin."
}

{
  "status": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please try again later."
}

{
  "status": false,
  "code": "INTERNAL_ERROR",
  "message": "İşlem gerçekleştirilemedi."
}

{
  "status": false,
  "code": "BANKPOS_RATES_UNAVAILABLE",
  "message": "Geçersiz veya eksik katalog cevabını sıfır oran saymayın."
}

{
  "status": false,
  "code": "BANKPOS_BRIDGE_UNAVAILABLE",
  "message": "Bağlantı şu anda kullanılamıyor; mali isteği otomatik tekrarlamayın."
}

Ne yapar?

Hoppa’dan aile/taksit bazlı alış kataloğunu alır. purchaseRate yüzde değeridir. Katalog hesabın satış tarifesini değiştirmez; ödeme sırasında kart ve tutara göre yeniden fiyatlanır. Eksik oran sıfır kabul edilmez. family=null aile bilgisi belirtilmemiş kayıttır.

Ön koşullar ve izin

Gereken izin: muhasip:epos:read. Açık izin her durumda zorunludur; genel erişim veya yönetici yetkisi bunun yerine geçmez. write tek başına read sağlamaz. Firma kimlik bilgilerinden belirlenir; ilişkili kayıtlar aynı firmaya ait olmalıdır. Firma paketi ücretli ve süresi aktif olmalıdır. Kimlik ve izinler · E-Pos entegrasyonu

İstek örnekleri

Örnekler temsilîdir. Kimlikleri, sürümleri ve işyeri bilgilerini kendi kayıtlarınızla değiştirin. Oranlar yüzde, amountMinor değerleri kuruştur. Gereken işlem anahtarını çağrıdan önce kalıcı saklayın; otomatik tekrar yapmayın. Gerçek işyeri anahtarını güvenli sunucu ortamından sağlayın. Node.js örneği Node.js 20 veya üzeri, PHP örneği cURL uzantısı gerektirir.

curl --request GET 'https://api.muhasip.pro/apps/bankpos/accounts/600000000000000000000001/installment-rates' \
  --user "$MUHASIP_API_USER_ID:$MUHASIP_API_SECRET" \
  --header 'Accept: application/json'

<?php
$apiUserId = getenv("MUHASIP_API_USER_ID");
$secret = getenv("MUHASIP_API_SECRET");
if (!$apiUserId || !$secret) {
    throw new RuntimeException("API kimlik bilgileri eksik.");
}
$headers = ["Accept: application/json"];
$curl = curl_init("https://api.muhasip.pro/apps/bankpos/accounts/600000000000000000000001/installment-rates");
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => $apiUserId . ":" . $secret,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_TIMEOUT => 100,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_HTTPHEADER => $headers
]);
$response = curl_exec($curl);
$httpStatus = curl_getinfo($curl, CURLINFO_HTTP_CODE);
if ($response === false) {
    curl_close($curl);
    throw new RuntimeException("Sonuç belirsiz; yeniden göndermeden işlem ve ödeme durumunu okuyun.");
}
curl_close($curl);
$result = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
// Ödeme bağlantısını veya gizli alanları günlüklemeyin.
echo json_encode(["httpStatus" => $httpStatus, "status" => $result["status"] ?? null, "id" => $result["result"]["_id"] ?? null, "operationId" => $result["operation"]["operationId"] ?? null], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);

async function main() {
  const apiUserId = process.env.MUHASIP_API_USER_ID
  const secret = process.env.MUHASIP_API_SECRET
  if (!apiUserId || !secret) throw new Error("API kimlik bilgileri eksik.")
  const headers = {
    Authorization: `Basic ${Buffer.from(`${apiUserId}:${secret}`, "utf8").toString("base64")}`,
    Accept: "application/json"
  }
  const response = await fetch(
    "https://api.muhasip.pro/apps/bankpos/accounts/600000000000000000000001/installment-rates",
    {
      method: "GET",
      headers,
      redirect: "error",
      signal: AbortSignal.timeout(100000)
    }
  )
  const result = await response.json()
  // Ödeme bağlantısını veya gizli alanları günlüklemeyin.
  console.log({
    httpStatus: response.status,
    status: result.status,
    id: result.result?._id,
    operationId: result.operation?.operationId
  })
}
main().catch(() => {
  console.error("Sonuç alınamadı; işlem/ödeme durumunu kontrol etmeden yeniden göndermeyin.")
  process.exitCode = 1
})

Cevabı değerlendirin

Aşağıdaki cevap temsilîdir; varsa url alanı örnekte yer tutucudur. Uygulamada dönen adresi doğrudan kullanın ve günlüklemeyin.

{
  "status": true,
  "result": {
    "accountId": "600000000000000000000001",
    "revision": 3,
    "fetchedAt": "2026-10-25T09:00:00.000Z",
    "rates": [
      {
        "family": "paraf",
        "installment": 1,
        "purchaseRate": 1.49
      },
      {
        "family": "paraf",
        "installment": 3,
        "purchaseRate": 4.8
      }
    ]
  }
}

Hata durumunda

HTTP / kod	Yapılacak işlem
`400 BANKPOS_INVALID_REQUEST`	İstek, kimlik, filtre veya oran biçimini düzeltin.
`401 UNAUTHORIZED`	API kimliği, erişim süresi ve firma durumunu kontrol edin.
`403 API_SCOPE_FORBIDDEN`	Açık E-Pos iznini, firma/IP ve paket koşullarını kontrol edin.
`429`	İstek sıklığını azaltın; mali çağrıyı körlemesine tekrarlamayın.
`500 INTERNAL_ERROR`	İstek tamamlanamadı; yazma sonucunu kayıttan kontrol edin.
`404 BANKPOS_ACCOUNT_NOT_FOUND`	Aynı firmaya ait hesap kimliğini kullanın.
`409 BANKPOS_REVISION_CONFLICT`	Güncel hesap veya tercih sürümünü okuyun.
`422 BANKPOS_RATES_UNSUPPORTED`	Sağlayıcının oran listeleme desteğini kontrol edin.
`422 BANKPOS_CREDENTIALS_REQUIRED`	Önce bağlantı bilgilerini kaydedin.
`502 BANKPOS_RATES_UNAVAILABLE`	Geçersiz veya eksik katalog cevabını sıfır oran saymayın.
`503 BANKPOS_BRIDGE_UNAVAILABLE`	Bağlantı şu anda kullanılamıyor; mali isteği otomatik tekrarlamayın.

Hata yönetimi · İşlem takibi

Sonraki adım

E-Pos entegrasyon akışını izleyin. Hesap değişikliğinde dönen revision değerini saklayın; ödemede bağlantı oluşturmayı, müşterinin 3D işlemini ve doğrulanmış mali sonucu ayrı değerlendirin.

Yetkilendirmeler

Authorization

string

header

gerekli

Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.

Yol Parametreleri

accountId

string

gerekli

Aynı firmaya ait 24 haneli kayıt kimliği.

Pattern: ^[a-fA-F0-9]{24}$

Yanıt

İşlem cevabı; örnek temsilîdir.

status

enum<boolean>

gerekli

Mevcut seçenekler:

true

result

object

gerekli

Show child attributes

Servis ve uygulamalar

Cari hesaplar

Kasa ve transferler

Alış-satış (e-belgesiz)

Ödemeler ve mahsuplaşma

Muhasebe seçenekleri

Fatura ve e-belge

Banka hesapları ve hareketleri

Banka otomasyonları

İş akışları ve alanlar

POS ve tahsilat

E-Pos

GİB e-Arşiv

Pazaryeri

Online işlemler

Proje ve görevler

Ajanda

Takvim

Mali işlem durumu

E-Pos alış oranlarını oku

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım

Yetkilendirmeler

Yol Parametreleri

Yanıt

​Ne yapar?

​Ön koşullar ve izin

​İstek örnekleri

​Cevabı değerlendirin

​Hata durumunda

​Sonraki adım

Yetkilendirmeler

Yol Parametreleri

Yanıt

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım