Partner API v1

Sipariş Detayı

Bu endpoint, sipariş listesinden dönen tek bir order_item_id için ürün, müşteri, satıcı, fiyat, kargo ve operasyon detaylarını almak için kullanılır.

GET /order_detail.php

Authentication HMAC SHA256 required

Scope Seller scoped

Permission orders:detail

Overview

Partner uygulaması yalnızca kurulu olduğu satıcıya ait sipariş detaylarını görebilir. Farklı satıcıya ait bir order_item_id gönderilirse erişim reddedilir veya kayıt bulunamadı cevabı döner.

Bu endpoint sipariş listesi endpointinden sonra kullanılır. Önce /orders.php ile siparişleri çekin, sonra dönen order_item_id değeriyle detay isteği gönderin.

Base URL

Environment

Production:
https://bazaardan.com/api/partner/v1

Endpoint:
GET /order_detail.php?order_item_id={order_item_id}

Required Headers

Header	Required	Description
`X-BZ-CLIENT-ID`	Yes	Partner uygulaması için üretilen Client ID.
`X-BZ-TIMESTAMP`	Yes	Unix timestamp. İmza üretiminde kullanılır.
`X-BZ-SIGNATURE`	Yes	Client Secret ile üretilen HMAC SHA256 imzası.
`Accept`	Recommended	`application/json`

Signature Base String

HMAC Base String

METHOD + "
" + PATH + "
" + TIMESTAMP + "
" + RAW_BODY

GET isteklerinde RAW_BODY boş string olmalıdır. PATH query string dahil endpoint path bilgisidir.

Query Parameters

Parameter	Type	Required	Description
`order_item_id`	integer	Yes	Sipariş kalemi ID değeri. `/orders.php` cevabından alınır.

Example Request

cURL

curl -X GET "https://bazaardan.com/api/partner/v1/order_detail.php?order_item_id=1024" \
  -H "Accept: application/json" \
  -H "X-BZ-CLIENT-ID: YOUR_CLIENT_ID" \
  -H "X-BZ-TIMESTAMP: 1778269200" \
  -H "X-BZ-SIGNATURE: GENERATED_HMAC_SIGNATURE"

Example Response

JSON

{
  "ok": true,
  "data": {
    "order": {
      "order_item_id": 1024,
      "order_no": "BD-202605080001",
      "status": "accepted",
      "payment_status": "paid",
      "currency": "TRY",
      "quantity": 1,
      "unit_price": 1499.90,
      "created_at": "2026-05-08 18:30:00",
      "updated_at": "2026-05-08 18:45:00"
    },
    "product": {
      "product_id": 356,
      "title": "Örnek Ürün",
      "sku": "SKU-001",
      "barcode": "8690000000001",
      "variant_combination_id": 778,
      "variant_summary": "Renk: Siyah / Beden: M"
    },
    "customer": {
      "full_name": "Example Customer",
      "city": "İstanbul",
      "district": "Kadıköy",
      "address": "Adres bilgisi sadece izin verilen kapsamda döner."
    },
    "shipment": {
      "carrier_code": "YURTICI",
      "shipment_ref": "BZTEST202605080001",
      "tracking_number": null,
      "status": "label_ready"
    }
  }
}

PHP Example

PHP

<?php

$clientId = 'YOUR_CLIENT_ID';
$clientSecret = 'YOUR_CLIENT_SECRET';

$method = 'GET';
$path = '/order_detail.php?order_item_id=1024';
$timestamp = (string) time();
$body = '';

$baseString = strtoupper($method) . "\n" . $path . "\n" . $timestamp . "\n" . $body;
$signature = hash_hmac('sha256', $baseString, $clientSecret);

$ch = curl_init('https://bazaardan.com/api/partner/v1' . $path);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'X-BZ-CLIENT-ID: ' . $clientId,
        'X-BZ-TIMESTAMP: ' . $timestamp,
        'X-BZ-SIGNATURE: ' . $signature,
    ],
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $httpCode . PHP_EOL;
echo $response . PHP_EOL;

Node.js Example

Node.js

import crypto from "node:crypto";

const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const method = "GET";
const path = "/order_detail.php?order_item_id=1024";
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = "";

const baseString = [
  method.toUpperCase(),
  path,
  timestamp,
  body
].join("\n");

const signature = crypto
  .createHmac("sha256", clientSecret)
  .update(baseString)
  .digest("hex");

const response = await fetch(`https://bazaardan.com/api/partner/v1${path}`, {
  method,
  headers: {
    "Accept": "application/json",
    "X-BZ-CLIENT-ID": clientId,
    "X-BZ-TIMESTAMP": timestamp,
    "X-BZ-SIGNATURE": signature
  }
});

console.log(response.status);
console.log(await response.json());

Python Example

Python

import time
import hmac
import hashlib
import requests

client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

method = "GET"
path = "/order_detail.php?order_item_id=1024"
timestamp = str(int(time.time()))
body = ""

base_string = "\n".join([
    method.upper(),
    path,
    timestamp,
    body,
])

signature = hmac.new(
    client_secret.encode("utf-8"),
    base_string.encode("utf-8"),
    hashlib.sha256
).hexdigest()

response = requests.get(
    "https://bazaardan.com/api/partner/v1" + path,
    headers={
        "Accept": "application/json",
        "X-BZ-CLIENT-ID": client_id,
        "X-BZ-TIMESTAMP": timestamp,
        "X-BZ-SIGNATURE": signature,
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Related Endpoints

Sipariş listesini almak için GET /orders.php endpointini kullanın.

Stok güncellemesi için POST /stock_update.php endpointini kullanın.