Senaryo
E-ticaret platformunuz veya pazaryeri webhook'u sipariş onaylanır onaylanmaz biHesap'a bir partner.sale.recorded gönderir. Tahsilat onayı geldiğinde partner.payment.recorded izler. Faturalama biHesap tarafında otomatik tetiklenir.
- Çoklu pazaryeri, tek akış
Trendyol, Shopify, kendi siteniz — hepsi aynı partner-api endpoint'ine event yazar. metadata.channel ile köken belli.
- İade event'i mı? Negatif quantity
Bir iade için aynı externalId ile partner.sale.recorded yeniden gönderilmez — yeni externalId + negatif quantity ile tersine kayıt açılır.
- Kargo masrafı line, gider değil
Müşteriden tahsil edilen kargo lines'a düz line olarak yazılır. Lojistik faturanız ayrı partner.expense.recorded olur.
Onaylanmış e-ticaret siparişi
POST /api/integrations/v1/sales
X-Integration-Key: biint_live_…
Idempotency-Key: 9c8b7a6d-5e4f-3210-fedc-ba9876543210
{
"externalId": "ORDER-WEB-2026-05-14-A77B",
"currency": "TRY",
"occurredAt": "2026-05-14T13:58:21Z",
"customerExternalId": "BUYER-elif@example.com",
"lines": [
{ "productId": "prd_tshirt_M", "quantity": 1, "unitAmountMinor": 24900 },
{ "productId": "prd_kargo_yk", "quantity": 1, "unitAmountMinor": 2500 }
],
"metadata": {
"channel": "trendyol",
"shipmentTrackingNo": "YK-9912387"
}
}Kullanılan event'ler
partner.sale.recorded, partner.payment.recorded, partner.expense.recorded