☰ Menü · Değişiklik günlüğü
Diğer

Değişiklik günlüğü

API'deki değişiklikler, en yeniden eskiye.

22 Kasım 2026

  • POST /v1/transactions, POST /v1/checks/calculate ve POST /v1/holds üzerinde cashier: fişi kimin kestiğini söyleyen bir metin ya da {id, name}. Fiş ve rezervle saklanır, cashier içinde döner ve işletme sahibinin kasiyer sinyallerinde kullanılır. Cashback'i asla değiştirmez ve idempotency kontrolüne girmez.

17 Kasım 2026

  • "Bir ziyarette misafir ya kazanır ya harcar" kuralı: harcama yapılan fiş cashback kazandırmaz ve POST /v1/checks/calculate ile POST /v1/transactions yanıtlarında earn_blocked: "redeemed" bulunur. Kural yoksa bu alan da yoktur.

16 Kasım 2026

  • Şubeler: işletme sahibi kasa kodlarını ve mağaza kodlarını şubelere bağlar. register_id yoksa veya bir şubeye bağlı değilse fiş, hesaplama ve rezervlerle store_id gönderin; yanıtlarda matched_by ile location bulunur. Bkz. şube ve kasa nasıl gönderilir.
  • Şube kuralları: kendi yüzdesi, kazanım kapalı, cashback ile ödeme şubede yasak veya sınırlı. Yasak olan yerde cashback'li bir fiş veya rezerv 400 redeem_not_allowed_here ile reddedilir, hesaplama redeem_blocked_reason döner. Şubeye göre ürün ve kategori istisnaları: GET /v1/catalog/location-rules.
  • Ada göre kategori: ayrıntılı kural sırası açık işletmeler line_items[].category içinde kategorinin hem adını hem kodunu kabul eder. Bir ad asla yeni kategori oluşturmaz; en özel kural kazanır.
  • Kampanyalı ürünler: line_items[].promo: true; işletme sahibi bu satırların cashback kazandırıp kazandırmayacağına ve cashback ile ödenip ödenemeyeceğine karar verir.
  • İndirim türleri: fişte ve satırlarda discount_type; işletme sahibi her tür için cashback kazandırıp kazandırmadığını ve cashback ile ödenip ödenemeyeceğini belirler, aksi halde 400 discount_redeem_not_allowed.
  • Ödeme veya indirim olarak cashback: indirim modunda her satırda redeem_allocated vardır; mod settings.redeem_accounting içindedir.
  • Çevrimdışı: GET /v1/account, settings içinde timeout_seconds, offline_redeem ve offline_max_hours döner. Bkz. Kasa çevrimdışıyken.
  • Hediyeler: POST /v1/checks/calculate gifts.pending ve gifts.unlocks, POST /v1/transactions gifts.unlocked döner; hediyeyi teslim edildi olarak işaretlemek için POST /v1/members/{member}/gifts/{gift_id}/give. Olaylar gift.unlocked ve gift.given.

5 Kasım 2026

  • Her işlemde ve POST /v1/checks/calculate yanıtında her satırın kazandırdığını içeren line_items var: amount, cashback_earned, earn_percent, redeemable, quantity_refunded.
  • Satır bazlı iadeler: POST /v1/transactions/{external_id}/refunds kod ve adetle line_items kabul eder; cashback her satırın gerçekten kazandırdığını izler.
  • Kart numarası ön eki: sahibi kasa kurallarında belirler, yeni kartlar onunla başlar; GET /v1/account içinde settings.card_prefix.
  • Ürün bazlı kurallar: sahip kategoriyi tek üründe, kalıcı veya tarihler arasında geçersiz kılar; GET /v1/catalog/products bunları rules içinde döndürür.
  • Cashback eksiye düşebilir: iade veya iptal, misafirin zaten harcadığı cashback'i geri alır, cashback.balance negatif olur ve bir sonraki fiş önce borcu kapatır.
  • Panel: kart diline göre doğum günü kutlamaları, görselsiz etkinlik ve doğum günü afişleri (metin kart tasarımının üzerine gelir), damgalar toplandığı anda değişen damga seviyeleri.
  • Panel: otomatik kampanyalar (ürün aldı, almayı bıraktı, segmente takvim) gönderim günlüğüyle; LTV'li alıcı kohortları; alınan ürünlere ve cashback bakiyesine göre segmentler.
  • Satır bazlı iade: POST /v1/transactions/{external_id}/returns iade edilen line_items alır ve cashback'i her satırın kazandırdığına göre taşır; satırlı iadeyle aynı motor, ayrı bir uç nokta olarak.

24 Ekim 2026

  • Gel-al siparişleri: location, pickup_at, guest ve day_number ile type: pickup.
  • Her siparişte payment ve history var. GET /v1/orders ?type= ve ?location= alır.
  • Zorunlu seçimi olan bir ürün seçimsiz eklenirse size ulaşmadan needs_options ile reddedilir.

9 Ekim 2026

  • İptal edilen ya da tamamen iade edilen fiş artık ziyaret ve harcama sayılmaz, bu yüzden iadeler misafirin cashback seviyesini yükseltmez.
  • /v1 altındaki bilinmeyen yollar site sayfası yerine JSON 404 endpoint_not_found döndürür; GET /v1 API'yi tanımlar.
  • Doğrulama hataları ne gönderileceğini söyler, örneğin amount alanının en küçük birimde tam sayı olduğunu.

7 Ekim 2026

  • Kasalar için işletme kuralları: rezervasyonla cashback kullanımı, kasa bazında fiş numaraları, geç gelen fişler için limit, fiş başına ve günlük cashback limitleri, zorunlu kart okutma, elle düzeltmeler. Her anahtarın kendi değerleri olabilir. GET /v1/account kuralları settings içinde döndürür.
  • Rezervasyonlar: POST /v1/holds, hold_id ile onaylama, kaldırma, süre dolunca otomatik kaldırma.
  • POST /v1/checks/calculate, hiçbir şey kaydetmeden bir fişin sonucunu gösterir.
  • Kısmi iadeler: POST /v1/transactions/{external_id}/refunds.
  • Katalog: ürünleri SKU ile yükleyin. İşletme sahibi her kategori için cashback kazandırıp kazandırmayacağını, cashback ile ödenip ödenemeyeceğini ve kendi oranını belirler.
  • Üyelerde cashback levels, next_level, held ve available alanları gösterilir.
  • Her fiş, tarama ve hesaplama, kasiyer ve fiş çıktısı için hazır metin içeren display alanını taşır.
  • Yeni izinler members:adjust, catalog:read, catalog:write. Yeni olaylar transaction.refunded, balance.adjusted.

6 Ekim 2026

  • /api/v1 adresinde API v1, tüm program türleri için: cashback, damga, ziyaret indirimi, VIP seviyeleri.
  • Üyeler: kendi kart numaranızla kayıt, kart, barkod, telefon veya id ile arama, geçmiş, ödül verme.
  • Program bazında kart barkodu biçimi: kart numaralı QR veya Code 128 ya da seri numaralı QR.
  • line_items destekli işlemler, iptaller, programın limitlerine uygun cashback harcama.
  • Kiosklar ve tarayıcılar: POST /v1/scans, POST /v1/visits, devices:write izni.
  • external_id alanında kendi SKU'larınızla menü API'si, fiyat ve tükenenler listesi için toplu senkronizasyon.
  • QR menüden masa siparişleri, POS için durum yönetimiyle.
  • İmzalı ve yeniden denemeli webhook'lar, Idempotency-Key, imleç tabanlı sayfalama, anahtar izinleri.
  • /api/pos/v1 adresindeki önceki POS API çalışmaya devam ediyor.
Entegrasyonla ilgili sorularınız için: api@loyaltyfy.io. Bir iş günü içinde yanıt veriyoruz.