Partner API v1

BaZaaRDan Partner API Dokümantasyonu

BaZaaRDan Partner API; ERP, muhasebe, stok ve sipariş yönetim sistemlerinin BaZaaRDan satıcı verilerine güvenli şekilde bağlanması için geliştirilmiştir.

Genel Bakış

Bu portal kimler için?

Bu dokümantasyon; ERP, muhasebe, depo, stok, kargo ve özel yazılım sistemlerini BaZaaRDan Partner API’ye bağlamak isteyen entegratör firmalar ve yazılım ekipleri için hazırlanmıştır.

ERP / muhasebe yazılım firmaları
Depo, stok ve kargo entegrasyonu yapan teknik ekipler
Satıcı adına özel entegrasyon geliştiren ajanslar
BaZaaRDan ile sistemsel veri alışverişi yapmak isteyen partnerler

Kimler için değildir?

Bu alan normal müşteri kullanımı veya günlük satıcı panel işlemleri için değildir. Satıcılar ürün, sipariş ve finans işlemlerini BaZaaRDan satıcı panelinden yönetmeye devam eder.

Müşteriler bu dokümanı kullanmaz.
Normal satıcılar teknik API anahtarı üretmez.
Client ID, Client Secret ve webhook tanımı BaZaaRDan admin/onay süreciyle verilir.

Entegrasyon Akışı

1 Yetkilendirme BaZaaRDan, onaylı entegratöre Client ID ve Client Secret bilgilerini verir.

2 Test Entegratör Postman, PHP SDK veya Node.js SDK ile bağlantıyı test eder.

3 Veri Alışverişi Siparişler çekilir, sipariş detayı alınır ve stok güncellemesi gönderilir.

4 Webhook Yeni sipariş ve stok gibi olaylar entegratörün webhook adresine otomatik iletilir.

İlk kurulum için Quick Start, hızlı test için Postman Collection, canlı entegrasyon için Authentication, Orders, Stock Update ve Webhooks sayfalarını takip edin.

Quick Start Client ID, imza üretimi, ilk ping ve sipariş testi için hızlı başlangıç. Postman Collection Hazır collection ve environment dosyalarıyla endpointleri hızlı test edin. PHP SDK PHP entegratörleri için HMAC imzalı örnek client ve webhook doğrulama paketi. Node.js SDK Node.js / TypeScript projeleri için hazır Partner API client yapısı. Webhooks Order, stock ve shipment eventlerini güvenli imza ile dinleme rehberi. Swagger UI Partner API v1 endpointlerini OpenAPI üzerinden inceleyin.

Sipariş Çekme

Satıcıya ait sipariş kalemleri ve detayları güvenli şekilde alınır.

Stok Güncelleme

ERP sisteminden ürün stoğu BaZaaRDan’a gönderilir.

Webhook

Yeni sipariş gibi olaylar entegrasyon sistemlerine anlık bildirilir.

Base URL

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

Authentication

Tüm istekler HMAC SHA256 imza ile gönderilmelidir.

Header	Açıklama
`X-BZ-CLIENT-ID`	Satıcıya verilen API client id
`X-BZ-TIMESTAMP`	ISO-8601 formatında istek zamanı
`X-BZ-SIGNATURE`	HMAC SHA256 imza

İmzalanacak Metin

METHOD + "\n" + PATH + "\n" + TIMESTAMP + "\n" + BODY

Örnek Bash İmza

CLIENT_SECRET="bzsec_xxx"
TS="$(date -Iseconds)"
PATH_ONLY="/api/partner/v1/orders.php"
BODY=""

SIG="$(printf "GET\n${PATH_ONLY}\n${TS}\n${BODY}" | openssl dgst -sha256 -hmac "$CLIENT_SECRET" -binary | xxd -p -c 256)"

Orders API

GET/orders.php?limit=5

Satıcıya ait sipariş kalemlerini listeler.

curl "https://bazaardan.com/api/partner/v1/orders.php?limit=5" \
  -H "X-BZ-CLIENT-ID: bzcli_xxx" \
  -H "X-BZ-TIMESTAMP: 2026-05-08T18:00:00+03:00" \
  -H "X-BZ-SIGNATURE: signature"

Order Detail API

GET/order_detail.php?order_item_id=124

Tek sipariş kaleminin ürün, adres, kargo ve ödeme bilgilerini döndürür.

Stock Update API

POST/stock_update.php

Ürün stoğunu product_id veya sku ile günceller.

{
  "product_id": 933,
  "stock": 9
}

Error Codes

Kod	Açıklama
`missing_auth_headers`	Kimlik doğrulama headerları eksik
`invalid_signature`	İmza doğrulanamadı
`expired_timestamp`	İstek zaman aşımına uğradı
`order_not_found`	Sipariş bulunamadı
`product_not_found`	Ürün bulunamadı
`forbidden_product`	Ürün bu satıcıya ait değil

Webhooks

Webhook engine bir sonraki fazda aktif edilecektir. Planlanan eventler: order.created, order.updated, stock.updated, return.requested.