☰ 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/calculatevePOST /v1/holdsüzerindecashier: fişi kimin kestiğini söyleyen bir metin ya da{id, name}. Fiş ve rezervle saklanır,cashieriç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/calculateilePOST /v1/transactionsyanıtlarındaearn_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_idyoksa veya bir şubeye bağlı değilse fiş, hesaplama ve rezervlerlestore_idgönderin; yanıtlardamatched_byilelocationbulunur. 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_hereile reddedilir, hesaplamaredeem_blocked_reasondö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[].categoryiç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 halde400 discount_redeem_not_allowed. - Ödeme veya indirim olarak cashback: indirim modunda her satırda
redeem_allocatedvardır; modsettings.redeem_accountingiçindedir. - Çevrimdışı:
GET /v1/account,settingsiçindetimeout_seconds,offline_redeemveoffline_max_hoursdöner. Bkz. Kasa çevrimdışıyken. - Hediyeler:
POST /v1/checks/calculategifts.pendingvegifts.unlocks,POST /v1/transactionsgifts.unlockeddöner; hediyeyi teslim edildi olarak işaretlemek içinPOST /v1/members/{member}/gifts/{gift_id}/give. Olaylargift.unlockedvegift.given.
5 Kasım 2026
- Her işlemde ve
POST /v1/checks/calculateyanıtında her satırın kazandırdığını içerenline_itemsvar:amount,cashback_earned,earn_percent,redeemable,quantity_refunded. - Satır bazlı iadeler:
POST /v1/transactions/{external_id}/refundskod ve adetleline_itemskabul 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/accountiçindesettings.card_prefix. - Ürün bazlı kurallar: sahip kategoriyi tek üründe, kalıcı veya tarihler arasında geçersiz kılar;
GET /v1/catalog/productsbunlarırulesiçinde döndürür. - Cashback eksiye düşebilir: iade veya iptal, misafirin zaten harcadığı cashback'i geri alır,
cashback.balancenegatif 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}/returnsiade edilenline_itemsalı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,guestveday_numberiletype: pickup. - Her siparişte
paymentvehistoryvar.GET /v1/orders?type=ve?location=alır. - Zorunlu seçimi olan bir ürün seçimsiz eklenirse size ulaşmadan
needs_optionsile 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.
/v1altındaki bilinmeyen yollar site sayfası yerine JSON404 endpoint_not_founddöndürür;GET /v1API'yi tanımlar.- Doğrulama hataları ne gönderileceğini söyler, örneğin
amountalanı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/accountkurallarısettingsiçinde döndürür. - Rezervasyonlar:
POST /v1/holds,hold_idile 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,heldveavailablealanları gösterilir. - Her fiş, tarama ve hesaplama, kasiyer ve fiş çıktısı için hazır metin içeren
displayalanını taşır. - Yeni izinler
members:adjust,catalog:read,catalog:write. Yeni olaylartransaction.refunded,balance.adjusted.
6 Ekim 2026
/api/v1adresinde 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_itemsdestekli işlemler, iptaller, programın limitlerine uygun cashback harcama.- Kiosklar ve tarayıcılar:
POST /v1/scans,POST /v1/visits,devices:writeizni. external_idalanı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/v1adresindeki önceki POS API çalışmaya devam ediyor.