Endpoint Bilgileri

• URL: /api/dealer/ibans
• Method: GET
• Headers: X-Dealer-Email, X-Dealer-Hash, Accept: application/json

Hash Oluşturma

hash('sha256', email + password)

$email = "[email protected]";
$password = "bayi-sifresi";
$hash = hash('sha256', $email . $password);

Örnek İstek

curl -X GET "/api/dealer/ibans" \
  -H "X-Dealer-Email: [email protected]" \
  -H "X-Dealer-Hash: {hash-değeri}" \
  -H "Accept: application/json"

Yanıt Formatı

{
  "success": true,
  "dealer_name": "Bayi Adı",
  "ibans": [
    {
      "id": 1,
      "iban_no": "TR123456789012345678901234",
      "bank_name": "Banka Adı",
      "account_name": "Hesap Adı",
      "branch_name": "Hesap Alıcı Adı",
      "wallet_id": "wallet123",
      "balance": 10000.00,
      "unavailable_balance": 1000.00
    }
  ]
}

Parametre Açıklamaları

Hata Yanıtları

Güvenlik Notları

• Şifrenizi asla ağ üzerinden göndermeyin
• API isteklerini her zaman HTTPS üzerinden yapın
• Her istek için hash değerini yeniden hesaplayın

Endpoint Bilgileri

• URL: /api/dealer/transactions
• Method: POST
• Headers: X-Dealer-Email, X-Dealer-Hash, Content-Type: application/json, Accept: application/json

İstek Parametreleri

Örnek İstek

curl -X POST "/api/dealer/transactions" \
  -H "X-Dealer-Email: [email protected]" \
  -H "X-Dealer-Hash: {hash-değeri}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "wallet_id": "A7F6E1AD-84F9-49E4-B6B4-953162591B4D",
    "sdate": "01-01-2023T00:00:00",
    "ldate": "31-01-2023T23:59:59"
  }'

Yanıt Formatı

{
  "success": true,
  "totalPage": 1,
  "transactionList": [
    {
      "transactionId": "12345",
      "transactionStatus": "1",
      "transactionStatusName": "Tamamlandı",
      "createdDate": "2023-01-15 14:30:45",
      "completedDate": "2023-01-15 14:31:02",
      "transactionTypeId": "6",
      "transactionTypeName": "Havale",
      "senderTypeId": "12",
      "senderTypeName": "Banka",
      "sender": "12345",
      "senderIban": "TR123456789012345678901234",
      "senderAccountHolderName": "Gönderen Ad Soyad",
      "senderDescription": "Test ödemesi",
      "receiverTypeId": "2",
      "receiverTypeName": "Hesap",
      "receiver": "67890",
      "receiverIban": "TR987654321098765432109876",
      "receiverAccountHolderName": "Alıcı Ad Soyad",
      "transactionAmount": 100000,
      "transactionFeeAmount": 0,
      "nextAmount": 100000,
      "currencyCode": "TRY"
    }
  ]
}

Yanıt Parametreleri

API, işlem listesini ve işlemlere ait detaylı bilgileri içeren bir JSON yanıtı döndürür. Ana parametreler:

transactionList içerisindeki her bir işleme ait parametreler:

Hata Yanıtları

Endpoint Bilgileri

• URL: /api/dealer/send-money
• Method: POST
• Headers: X-Dealer-Email, X-Dealer-Hash, Content-Type: application/json, Accept: application/json

İstek Parametreleri

Örnek İstek

curl -X POST "/api/dealer/send-money" \
  -H "X-Dealer-Email: [email protected]" \
  -H "X-Dealer-Hash: {hash-değeri}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "walletId": "54C0B13D-E1D3-4F9E-90E4-E32542887D02",
    "miktar": 100050,
    "iban": "TR330006100519786457841326",
    "aliciAdi": "Ahmet Yılmaz",
    "aciklama": "Bayiye ödeme",
    "transactionId": "BAY2406051234001"
  }'

Yanıt Formatı

{
  "success": true,
  "message": "Para gönderme işlemi başarıyla başlatıldı",
  "transaction_id": "BAY2406051234001",
  "details": {
    "Success": true,
    "ResponseCode": "0000",
    "ResponseDescription": "İşlem başarılı",
    "transactionId": "000000000123456",
    "transactionDetails": [
      {
        "transactionId": "000000000123456",
        "senderWalletId": "54C0B13D-E1D3-4F9E-90E4-E32542887D02",
        "receiverIban": "TR330006100519786457841326",
        "paymentType": "99",
        "amount": 100050,
        "currencyCode": "TRY",
        "status": "Pending"
      }
    ]
  }
}

Yanıt Parametreleri

API, işlem sonucunu ve detaylarını içeren bir JSON yanıtı döndürür.

Olası Hata Yanıtları

Callback Örneği

İşlem tamamlandığında (başarılı veya başarısız) belirtilen callback URL'e aşağıdaki formatta POST isteği gönderilir:

{
  "success": true,
  "message": "Para gönderme işlemi başarıyla tamamlandı",
  "transaction_id": "BAY2406051234001",
  "timestamp": 1717500000
}

Başarısız işlem örneği:

{
  "success": false,
  "message": "Yetersiz bakiye",
  "transaction_id": "BAY2406051234001",
  "timestamp": 1717500000
}

Not: Callback sistemi asenkron çalışır ve işlem sonucundan bağımsız olarak her zaman HTTP 200 yanıtı beklenir.

Güvenlik Notları

• Her istek için X-Dealer-Hash değerini yeniden hesaplayın
• Para transfer işlemleri geri alınamaz, lütfen miktar değerlerini dikkatli kontrol edin
• İşlemleri her zaman HTTPS üzerinden yapın
• Büyük miktarlar için test işlemi yapıp onaylayın

Endpoint Bilgileri

• URL: /api/dealer/status
• Method: POST
• Headers: X-Dealer-Email, X-Dealer-Hash, Content-Type: application/json, Accept: application/json

İstek Parametreleri

Örnek İstek

curl -X POST "/api/dealer/status" \
  -H "X-Dealer-Email: [email protected]" \
  -H "X-Dealer-Hash: {hash-değeri}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "wallet_id": "123456",
    "transaction_id": "TRX789"
  }'

Başarılı Yanıt

{
  "success": true,
  "transaction": {
    "transaction_id": "TRX789",
    "transaction_type_id": "6",
    "transaction_amount": 1000.00,
    "sender_wallet_id": "123456",
    "receiver_wallet_id": "789012",
    "sender_iban": "TR123456789",
    "receiver_iban": "TR987654321",
    "status": "Onaylandı",
    "created_date": "2024-03-20 10:30:00",
    "updated_date": "2024-03-20 10:35:00",
    "description": "Para Transferi"
  }
}

Hata Yanıtları

{
  "success": false,
  "message": "Bu wallet ID bayiye atanmamış veya aktif değil"
}

{
  "success": false,
  "message": "İşlem bulunamadı"
}

{
  "success": false,
  "message": "İşlem durumu sorgulanırken bir hata oluştu: [hata mesajı]"
}