E-Pos hesaplarını listele

{
  "status": true,
  "result": [
    {
      "_id": "600000000000000000000001",
      "name": "Merkez Hoppa",
      "providerCode": "esnekpos",
      "providerKind": "paymentInstitution",
      "environment": "test",
      "status": "draft",
      "revision": 1,
      "identity": {
        "merchant": "ORNEK_ISYERI"
      },
      "currencies": [
        "TRY"
      ],
      "installments": [
        1,
        3
      ],
      "installmentRates": [
        {
          "installment": 1,
          "enabled": true,
          "purchaseRate": null,
          "saleRate": 0
        },
        {
          "installment": 3,
          "enabled": true,
          "purchaseRate": null,
          "saleRate": 1
        }
      ],
      "familySaleRates": [
        {
          "family": "paraf",
          "installment": 3,
          "saleRate": 0
        }
      ],
      "credentialsConfigured": false,
      "ratesConfigured": true,
      "credentialVersionId": null,
      "credentialsUpdatedAt": null,
      "connectionCheck": {
        "status": "not_checked",
        "checkedAt": null
      },
      "integrationStatus": "implemented",
      "canActivate": false,
      "createdAt": "2026-10-25T09:00:00.000Z",
      "updatedAt": "2026-10-25T09:00:00.000Z",
      "archivedAt": null,
      "createdBy": "600000000000000000000003",
      "updatedBy": "600000000000000000000003"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

{
  "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,
  "code": "BANKPOS_PROVIDER_UNKNOWN",
  "message": "Katalogdaki sağlayıcı kodunu kullanın."
}

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

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

GET

https://api.muhasip.pro

apps

bankpos

accounts

{
  "status": true,
  "result": [
    {
      "_id": "600000000000000000000001",
      "name": "Merkez Hoppa",
      "providerCode": "esnekpos",
      "providerKind": "paymentInstitution",
      "environment": "test",
      "status": "draft",
      "revision": 1,
      "identity": {
        "merchant": "ORNEK_ISYERI"
      },
      "currencies": [
        "TRY"
      ],
      "installments": [
        1,
        3
      ],
      "installmentRates": [
        {
          "installment": 1,
          "enabled": true,
          "purchaseRate": null,
          "saleRate": 0
        },
        {
          "installment": 3,
          "enabled": true,
          "purchaseRate": null,
          "saleRate": 1
        }
      ],
      "familySaleRates": [
        {
          "family": "paraf",
          "installment": 3,
          "saleRate": 0
        }
      ],
      "credentialsConfigured": false,
      "ratesConfigured": true,
      "credentialVersionId": null,
      "credentialsUpdatedAt": null,
      "connectionCheck": {
        "status": "not_checked",
        "checkedAt": null
      },
      "integrationStatus": "implemented",
      "canActivate": false,
      "createdAt": "2026-10-25T09:00:00.000Z",
      "updatedAt": "2026-10-25T09:00:00.000Z",
      "archivedAt": null,
      "createdBy": "600000000000000000000003",
      "updatedBy": "600000000000000000000003"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

{
  "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,
  "code": "BANKPOS_PROVIDER_UNKNOWN",
  "message": "Katalogdaki sağlayıcı kodunu kullanın."
}

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

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

Ne yapar?

Firmanın kendi banka/ödeme kuruluşu POS hesaplarını sayfalar. Varsayılan liste arşivlenmiş hesapları içermez; status=archived ile okunur. Sırlar geri verilmez.

Ö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?page=1&pageSize=25' \
  --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?page=1&pageSize=25");
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?page=1&pageSize=25", {
    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": [
    {
      "_id": "600000000000000000000001",
      "name": "Merkez Hoppa",
      "providerCode": "esnekpos",
      "providerKind": "paymentInstitution",
      "environment": "test",
      "status": "draft",
      "revision": 1,
      "identity": {
        "merchant": "ORNEK_ISYERI"
      },
      "currencies": ["TRY"],
      "installments": [1, 3],
      "installmentRates": [
        {
          "installment": 1,
          "enabled": true,
          "purchaseRate": null,
          "saleRate": 0
        },
        {
          "installment": 3,
          "enabled": true,
          "purchaseRate": null,
          "saleRate": 1
        }
      ],
      "familySaleRates": [
        {
          "family": "paraf",
          "installment": 3,
          "saleRate": 0
        }
      ],
      "credentialsConfigured": false,
      "ratesConfigured": true,
      "credentialVersionId": null,
      "credentialsUpdatedAt": null,
      "connectionCheck": {
        "status": "not_checked",
        "checkedAt": null
      },
      "integrationStatus": "implemented",
      "canActivate": false,
      "createdAt": "2026-10-25T09:00:00.000Z",
      "updatedAt": "2026-10-25T09:00:00.000Z",
      "archivedAt": null,
      "createdBy": "600000000000000000000003",
      "updatedBy": "600000000000000000000003"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

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.
`422 BANKPOS_PROVIDER_UNKNOWN`	Katalogdaki sağlayıcı kodunu kullanı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.

Sorgu Parametreleri

page

integer

varsayılan:1

Sayfa numarası.

Gerekli aralık: 1 <= x <= 10000

pageSize

integer

varsayılan:25

Sayfadaki kayıt sayısı.

Gerekli aralık: 1 <= x <= 100

status

enum<string>

Hesap durumu filtresi.

Mevcut seçenekler:

draft,

active,

disabled,

archived

environment

enum<string>

İsteğe bağlı ortam filtresi; yeni hesabın ortamını seçmez. Firma hesabının test bilgisine göre belirlenir; hesap oluştururken seçilmez.

Mevcut seçenekler:

test,

production

providerCode

string

Sağlayıcı kodu filtresi.

providerKind

enum<string>

Sağlayıcı türü.

Mevcut seçenekler:

bank,

paymentInstitution

string

Hesap adı araması.

Required string length: 1 - 120

Yanıt

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

status

enum<boolean>

gerekli

Mevcut seçenekler:

true

result

object[]

gerekli

Show child attributes

total

integer

gerekli

Gerekli aralık: x >= 0

page

integer

gerekli

Gerekli aralık: x >= 1

pageSize

integer

gerekli

Gerekli aralık: 1 <= x <= 100

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 hesaplarını listele

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım

Yetkilendirmeler

Sorgu Parametreleri

Yanıt

​Ne yapar?

​Ön koşullar ve izin

​İstek örnekleri

​Cevabı değerlendirin

​Hata durumunda

​Sonraki adım

Yetkilendirmeler

Sorgu Parametreleri

Yanıt

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım