LiderHavale Partner API LiderHavale Partner API

{
  "auth": {
    "apiKey": "API_ANAHTARINIZ",
    "secKey": "GIZLI_ANAHTARINIZ"
  },
  "customer": {
    "id":       "123123",       // sizdeki müşteri no
    "username": "testmusteri",
    "fullName": "Ahmet Yılmaz"   // banka hesabındaki ad
  },
  "transactionId": "456785",      // sizde tekil olmalı
  "returnUrl":     "https://siteniz.com/hesabim",
  "amount":        1000
}

{
  "status": true,
  "deposit": {
    "customer": {
      "fullName": "Ahmet Yılmaz",
      "username": "testmusteri",
      "id": "123123"
    },
    "transactionId": "456785",
    "amount": 1000,
    "partner": "6453f2b3c4b1361de57edf90",
    "status": "PROCESSING",
    "_id": "64c76bfacfe287ddf963ce49",
    "created_at": "2026-01-01T08:08:26.340Z"
  },
  "token": "pZk3_9vQxT2Lm8Rd...",
  "paymentUrl": "https://payment.liderhavale.com/?token=pZk3_9vQxT2Lm8Rd..."
}

https://payment.liderhavale.com/?token=${token}

{
  "auth": {
    "apiKey": "API_ANAHTARINIZ",
    "secKey": "GIZLI_ANAHTARINIZ"
  },
  "customer": {
    "id": "123456",
    "username": "testmusteri",
    "fullName": "Ahmet Yılmaz"
  },
  "transactionId": "123123",
  "iban":          "TR760009901234567800100001",
  "bank":          "65c6525532c59fcd5af4a4b3",  // /api/bank içindeki _id
  "amount":        1000
}

{
  "status": true,
  "withdraw": {
    "customer": { "fullName": "Ahmet Yılmaz",
                   "username": "testmusteri",
                   "id": "123456" },
    "bank": "65c6525532c59fcd5af4a4b3",
    "iban": "TR760009901234567800100001",
    "transactionId": "123123",
    "amount": 1000,
    "partner": "6453f2b3c4b1361de57edf90",
    "status": "PROCESSING",
    "_id": "64c769013f547212cdb46415",
    "created_at": "2026-01-01T07:55:45.150Z"
  }
}

{
  "status": true,
  "data": [
    {
      "_id": "6453f2c8c4b1361de57edfc2",
      "name": "GARANTİ BANKASI",
      "code": "0062",
      "enabled": true,
      "created_at": "2026-01-01T18:00:40.003Z",
      "updated_at": "2026-01-01T18:00:40.003Z"
    },
    {
      "_id": "64c852d8f7fa26fc12daabb2",
      "name": "HALKBANK",
      "code": "0012",
      "enabled": true,
      "created_at": "2026-01-02T00:33:28.724Z",
      "updated_at": "2026-01-02T00:33:28.724Z"
    }
  ]
}

// Node.js
const crypto = require("crypto");

const hashRequestSignature = (secret, text) =>
  crypto.createHash("sha1").update(`${secret}${text}`).digest("hex");

// Gelen bildirimi doğrulama
function bildirimGecerli(govde, secKey) {
  const metin = `transactionId=${govde.transactionId}&amount=${govde.amount}&status=${govde.status}`;
  return hashRequestSignature(secKey, metin) === govde.hash;
}

const cevap = await fetch(url, { method: "POST", headers, body });
const govde = await cevap.json();

// YANLIŞ: iş kuralı hatası da 200 döner
// if (cevap.ok) { bakiyeYukle(); }

// DOĞRU
if (!cevap.ok)      throw new Error(`HTTP ${cevap.status}: ${govde.message}`);
if (!govde.status)  throw new Error(govde.message);  // iş kuralı

// buraya geldiyseniz işlem gerçekten açıldı
musteriyiYonlendir(govde.token);

<?php
$govde = [
  'auth' => ['apiKey' => getenv('LH_API_KEY'), 'secKey' => getenv('LH_SEC_KEY')],
  'customer' => ['id' => '123123', 'username' => 'testmusteri', 'fullName' => 'Ahmet Yılmaz'],
  'transactionId' => 'DEP-' . $siparisNo,        // sizde tekil
  'returnUrl' => 'https://siteniz.com/hesabim',
  'amount' => 1000,
];
$ch = curl_init('https://api.liderhavale.com/api/payment/deposit/with-partner');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 20,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode($govde, JSON_UNESCAPED_UNICODE),
]);
$cevap = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http === 200 && !empty($cevap['status'])) {
  header('Location: ' . $cevap['paymentUrl']);   // müşteriyi ödeme sayfasına gönder
  exit;
}
// status:false → $cevap['message'] müşteriye gösterilebilir (limit, kapalı yatırım…)
error_log('LiderHavale: ' . ($cevap['message'] ?? "HTTP $http"));

const cevap = await fetch("https://api.liderhavale.com/api/payment/deposit/with-partner", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    auth: { apiKey: process.env.LH_API_KEY, secKey: process.env.LH_SEC_KEY },
    customer: { id: "123123", username: "testmusteri", fullName: "Ahmet Yılmaz" },
    transactionId: `DEP-${siparisNo}`,          // sizde tekil
    returnUrl: "https://siteniz.com/hesabim",
    amount: 1000,
  }),
  signal: AbortSignal.timeout(20000),
});
const govde = await cevap.json();
if (cevap.ok && govde.status) {
  return res.redirect(govde.paymentUrl);      // müşteriyi ödeme sayfasına gönder
}
throw new Error(govde.message || `HTTP ${cevap.status}`);

curl -X POST https://api.liderhavale.com/api/payment/deposit/with-partner \
  -H "Content-Type: application/json" \
  -d '{
    "auth": { "apiKey": "API_ANAHTARINIZ", "secKey": "GIZLI_ANAHTARINIZ" },
    "customer": { "id": "123123", "username": "testmusteri", "fullName": "Ahmet Yılmaz" },
    "transactionId": "DEP-1001",
    "returnUrl": "https://siteniz.com/hesabim",
    "amount": 1000
  }'

<?php
$b = json_decode(file_get_contents('php://input'), true) ?: [];
$metin = "transactionId={$b['transactionId']}&amount={$b['amount']}&status={$b['status']}";
$beklenen = sha1(getenv('LH_SEC_KEY') . $metin);

if (!hash_equals($beklenen, (string)($b['hash'] ?? ''))) {
  http_response_code(401); exit('imza hatali');     // 200 dönmeyin: sahte istek
}
if ($b['status'] === 'TEST') { http_response_code(200); exit('ok'); }

// Aynı bildirim birden çok kez gelebilir: işlemi yalnız BİR kez uygulayın.
$db->beginTransaction();
$islem = $db->kilitleVeGetir($b['transactionId']);          // SELECT … FOR UPDATE
if ($islem && $islem['durum'] !== $b['status']) {
  if ($b['type'] === 'deposit' && $b['status'] === 'CONFIRMED') {
    $db->bakiyeEkle($islem['musteri'], $b['amount']);          // DİKKAT: istenen değil, gelen tutar
  }
  if ($b['type'] === 'withdraw' && $b['status'] === 'REJECTED') {
    $db->bakiyeIadeEt($islem['musteri'], $islem['tutar']);
  }
  $db->durumYaz($b['transactionId'], $b['status']);
}
$db->commit();
http_response_code(200);
echo 'ok';

const crypto = require("crypto");

app.post("/liderhavale/bildirim", express.json(), async (req, res) => {
  const b = req.body || {};
  const metin = `transactionId=${b.transactionId}&amount=${b.amount}&status=${b.status}`;
  const beklenen = crypto.createHash("sha1").update(process.env.LH_SEC_KEY + metin).digest("hex");
  const esit = beklenen.length === String(b.hash).length &&
    crypto.timingSafeEqual(Buffer.from(beklenen), Buffer.from(String(b.hash)));
  if (!esit) return res.status(401).send("imza hatali");
  if (b.status === "TEST") return res.send("ok");

  // Idempotent: aynı durum ikinci kez gelirse hiçbir şey yapmadan 200 dönün.
  await db.transaction(async (t) => {
    const islem = await t.islemKilitle(b.transactionId);
    if (!islem || islem.durum === b.status) return;
    if (b.type === "deposit" && b.status === "CONFIRMED") await t.bakiyeEkle(islem.musteri, b.amount);
    if (b.type === "withdraw" && b.status === "REJECTED") await t.bakiyeIade(islem.musteri, islem.tutar);
    await t.durumYaz(b.transactionId, b.status);
  });
  res.send("ok");                                  // 15 sn içinde HTTP 200
});