E-Pos sağlayıcılarını listele

{
  "status": true,
  "result": [
    {
      "code": "esnekpos",
      "name": "Hoppa (EsnekPos)",
      "kind": "paymentInstitution",
      "configurationReady": true,
      "integrationStatus": "implemented",
      "schemaVersion": 1,
      "environments": [
        "test",
        "production"
      ],
      "currencies": [
        "TRY",
        "USD",
        "EUR",
        "GBP"
      ],
      "installments": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12
      ],
      "identityFields": [
        {
          "key": "merchant",
          "label": "Üye İşyeri Kodu (MERCHANT)",
          "required": true,
          "maxLength": 120
        }
      ],
      "credentialFields": [
        {
          "key": "merchantKey",
          "label": "Üye İşyeri Anahtarı (MERCHANT_KEY)",
          "required": true,
          "maxLength": 512,
          "secret": true
        }
      ],
      "capabilities": {
        "checkout": true,
        "connectionCheck": true,
        "installmentRates": true,
        "paymentQuery": true,
        "void": true,
        "refund": true,
        "partialRefund": false
      }
    }
  ]
}

{
  "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": 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

providers

{
  "status": true,
  "result": [
    {
      "code": "esnekpos",
      "name": "Hoppa (EsnekPos)",
      "kind": "paymentInstitution",
      "configurationReady": true,
      "integrationStatus": "implemented",
      "schemaVersion": 1,
      "environments": [
        "test",
        "production"
      ],
      "currencies": [
        "TRY",
        "USD",
        "EUR",
        "GBP"
      ],
      "installments": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12
      ],
      "identityFields": [
        {
          "key": "merchant",
          "label": "Üye İşyeri Kodu (MERCHANT)",
          "required": true,
          "maxLength": 120
        }
      ],
      "credentialFields": [
        {
          "key": "merchantKey",
          "label": "Üye İşyeri Anahtarı (MERCHANT_KEY)",
          "required": true,
          "maxLength": 512,
          "secret": true
        }
      ],
      "capabilities": {
        "checkout": true,
        "connectionCheck": true,
        "installmentRates": true,
        "paymentQuery": true,
        "void": true,
        "refund": true,
        "partialRefund": false
      }
    }
  ]
}

{
  "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": 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?

Sağlayıcı kimliği, alanları ve desteklenen işlemleri döndürür. integrationStatus=planned olan sağlayıcıyla taslak hesap açılabilir; etkinleştirme, bağlantı ve ödeme yapılamaz. Ödeme akışı için Hoppa (esnekpos) desteklenir.

Ö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/providers' \
  --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/providers");
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/providers", {
    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": [
    {
      "code": "esnekpos",
      "name": "Hoppa (EsnekPos)",
      "kind": "paymentInstitution",
      "configurationReady": true,
      "integrationStatus": "implemented",
      "schemaVersion": 1,
      "environments": ["test", "production"],
      "currencies": ["TRY", "USD", "EUR", "GBP"],
      "installments": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12],
      "identityFields": [
        {
          "key": "merchant",
          "label": "Üye İşyeri Kodu (MERCHANT)",
          "required": true,
          "maxLength": 120
        }
      ],
      "credentialFields": [
        {
          "key": "merchantKey",
          "label": "Üye İşyeri Anahtarı (MERCHANT_KEY)",
          "required": true,
          "maxLength": 512,
          "secret": true
        }
      ],
      "capabilities": {
        "checkout": true,
        "connectionCheck": true,
        "installmentRates": true,
        "paymentQuery": true,
        "void": true,
        "refund": true,
        "partialRefund": false
      }
    }
  ]
}

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.

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.

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 sağlayıcılarını listele

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım

Yetkilendirmeler

Yanıt

​Ne yapar?

​Ön koşullar ve izin

​İstek örnekleri

​Cevabı değerlendirin

​Hata durumunda

​Sonraki adım

Yetkilendirmeler

Yanıt

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım