@rewloy/node 0.2.1 → 0.2.2

package/dist/generated/methods.js

@@ -1,5 +1,5 @@
 // Generated by scripts/generate.ts from the Rewloy OpenAPI document
-// (openapi/openapi.json, API 1.0.0). Do not edit: run `npm run generate`.
+// (openapi/openapi.json, API 1.1.0). Do not edit: run `npm run generate`.
 /** One method per operation of the API, named by its operationId. `Rewloy` extends it. */
 export class RewloyMethods {
     // ------------------------------------------------------------ Kartlar
@@ -8,7 +8,7 @@ export class RewloyMethods {
      *
      * Bir programdan kart verir. E-posta gönderilirse kart o müşteriye bağlanır (yoksa oluşturulur) ve `kvkkConsent: true` gönderilmelidir: bu, işletmenin müşteriye kendi aydınlatma metnini sunduğunu beyan etmesidir; beyanın doğruluğundan işletme sorumludur. Bir rıza kutusu olarak sormayın. Dönen `cardUrl` müşterinin özel kart bağlantısıdır: müşteriye iletin, kayıtlara yazmayın. Hediye kartında `faceMinor` (kuruş) zorunludur. Yanıtta `created` her zaman vardır.
      * - **Idempotency-Key** (isteğe bağlı, önerilir): her çağrı yeni bir kart açar; başlıkla aynı anahtar ve aynı gövdeyle tekrar yeni kart açmaz, ilk yanıtı (aynı kart, aynı bağlantı) `Idempotent-Replayed: true` ile döndürür. Aynı anahtar başka bir gövdeyle `422 IDEMPOTENCY_KEY_REUSED`. Bir siparişe kart açan mağaza için sipariş başına sabit bir anahtar iyi bir seçimdir. Saklanan yanıt şifrelidir ve 7 gün tutulur; tekrar yalnız kimlik o programda hâlâ kart verebiliyorsa döner (yoksa `403 FORBIDDEN`).
-     * - **`ifExists`** (isteğe bağlı, `email` ile): `"create"` (varsayılan) her çağrıda yeni kart açar, bugüne dek olduğu gibi. `"return"`: kişinin bu programda açık bir kartı varsa yeni kart açılmaz; `200`, `created: false` ve o kartın `serial`'i döner — mağazanın kendi e-posta → kart tablosu tutması gerekmez. Var olan kartın `cardUrl`'i **görüntüleme anahtarı taşımaz** (`/p/{serial}`, kişiye bir şey göstermez ve bağlantıyı e-postasına istemeyi önerir): adresi yazan kişi kartın sahibi olmayabilir, özel bağlantı yalnız kişinin kendi e-postasına gider (`sendEmail`). Kart yoksa yeni kart açılır (`201`, `created: true`). Yanıt bu adresin bu programda kartı olup olmadığını ve kartın numarasını (kasada kartla işlem yapılan anahtar) söylediği için **kimliğin kartın programında `customers.read` yetkisi olmalı** ve müşteri kimliğin şube kapsamında olmalıdır; yoksa `403 FORBIDDEN` (ADR 182'nin incelemesi). Hediye kartında kullanılamaz (her hediye kartı bir satın almadır; `400 VALIDATION`). Koddan verilen kartlar (kupon, indirim) "açık kart" sayılmaz.
+     * - **`ifExists`** (isteğe bağlı, `email` ile): `"create"` (varsayılan) her çağrıda yeni kart açar, bugüne dek olduğu gibi. `"return"`: kişinin bu programda açık bir kartı varsa yeni kart açılmaz; `200`, `created: false` ve o kartın `serial`'i döner — mağazanın kendi e-posta → kart tablosu tutması gerekmez. Var olan kartın `cardUrl`'i **görüntüleme anahtarı taşımaz** (`/p/{serial}`, kişiye bir şey göstermez ve bağlantıyı e-postasına istemeyi önerir): adresi yazan kişi kartın sahibi olmayabilir, özel bağlantı yalnız kişinin kendi e-postasına gider (`sendEmail`). Kart yoksa yeni kart açılır (`201`, `created: true`). Yanıt bu adresin bu programda kartı olup olmadığını ve kartın numarasını (kasada kartla işlem yapılan anahtar) söylediği için **kimliğin kartın programında `customers.read` yetkisi olmalı** ve müşteri kimliğin şube kapsamında olmalıdır; yoksa `403 FORBIDDEN`. Hediye kartında kullanılamaz (her hediye kartı bir satın almadır; `400 VALIDATION`). Koddan verilen kartlar (kupon, indirim) "açık kart" sayılmaz.
      * - **`sendEmail: true`** (isteğe bağlı, `email` ile): katılım formunun gönderdiği "kartınız" e-postası kişinin adresine gider; yeni kartta yeni kartın bağlantısıyla, var olan kartta (`created: false`) o kart için yeni bir bağlantıyla (eski bağlantılar çalışmaya devam eder). Sınırlar: kişi başına saatte 3 (yeni kart da sayılır; katılım formuyla ortak), işletme başına saatte 50 (deneme süresinde) ya da 500; fazlası gönderilmez, `rate_limited` (kart yine açılır). İşletmenin etkin bir sahibinin e-posta adresi doğrulanmamışsa çağrı `403 OWNER_EMAIL_UNVERIFIED` ile reddedilir, kart açılmaz. Gönderim `kvkkConsent: true` ile kaydedilen beyana dayanır. Test ortamında e-posta gönderilmez, "Gönderilmeyenler"e yazılır. Yanıttaki `emailStatus`: `queued` (gönderim sırasına girdi; test ortamında Gönderilmeyenler'e yazıldı), `suppressed` (adres daha önce geri döndüğü ya da şikâyet ettiği için gönderilmedi), `rate_limited`, `not_sent`.
      * - **Bir sipariş için kart** (`orderId` ve `shopId` birlikte, `email` ile): kartı kazandıran sipariş de bu karta sayılır, mağazanın sipariş bildirimi karttan önce ya da sonra gelsin. Bildirim henüz gelmediyse (`order.result: waiting`) geldiğinde bu kartı bulur. Önce gelip "Kartı yok" diye kaydedildiyse (`resend`) sipariş yeniden açılır: mağaza siparişi 7 gün içinde yeniden gönderdiğinde (aynı imzalı bildirim; WooCommerce eklentisi webhook'unun o siparişi yeniden teslimiyle) siparişin kendi e-postası ve tutarıyla bu karta işlenir. Tutar hiçbir zaman bu çağrıdan alınmaz, siparişten hiçbir şey saklanmaz ve sipariş yine bir kez sayılır. Bağlantı bu işletmenin ve bu programın olmalıdır (`404 SHOP_NOT_FOUND`, `409 SHOP_PROGRAM_MISMATCH`). `ifExists: "return"` ile var olan kart döndüğünde de sipariş, e-postasıyla o kartı bulur.
      *
@@ -42,7 +42,7 @@ export class RewloyMethods {
     /**
      * Kartın bir şubedeki kasa kuralları
      *
-     * Kasada işlem yapmadan önce: kart bu şubede kullanılabilir mi, hangi şubelerde geçerli, şu an burada hangi kasa kampanyası çalışıyor ve kasiyerin göreceği uyarılar (tarayıcıdaki şeritlerin aynısı). `allowed: false` iken işlem `WRONG_LOCATION` ile reddedilir (ADR 139). Şube kartın işletmesinin silinmemiş bir şubesi olmalıdır, değilse `404 LOCATION_NOT_FOUND` (kasa işlemleri gibi).
+     * Kasada işlem yapmadan önce: kart bu şubede kullanılabilir mi, hangi şubelerde geçerli, şu an burada hangi kasa kampanyası çalışıyor ve kasiyerin göreceği uyarılar (tarayıcıdaki şeritlerin aynısı). `allowed: false` iken işlem `WRONG_LOCATION` ile reddedilir. Şube kartın işletmesinin silinmemiş bir şubesi olmalıdır, değilse `404 LOCATION_NOT_FOUND` (kasa işlemleri gibi).
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -58,7 +58,7 @@ export class RewloyMethods {
     /**
      * Kasada işlem
      *
-     * Karta, bir şubede kasa işlemi uygular. **Idempotency-Key zorunludur** (8–64 karakter, bu kimlik için kalıcı olarak tekil): aynı anahtarla aynı isteğin tekrarı bakiyeyi ikinci kez değiştirmez ve ilk sonucu döndürür (`duplicate: true`); bu kartta başka bir işlem için ya da başka bir gövdeyle (başka tutar, şube, sayı) kullanılmış bir anahtar `422 IDEMPOTENCY_KEY_REUSED` alır ve hiçbir şey yazılmaz. `currency` (isteğe bağlı) verilirse kartın para birimiyle karşılaştırılır (`422 CURRENCY_MISMATCH`). Şube işletmenizin silinmemiş bir şubesi olmalıdır (`404 LOCATION_NOT_FOUND`). Salt-okunur hesapta da çalışır: mevcut kartlar çalışmaya devam eder.
+     * Karta, bir şubede kasa işlemi uygular. **Idempotency-Key zorunludur** (8–64 karakter, yalnız ASCII, bu kimlik için kalıcı olarak tekil): aynı anahtarla aynı isteğin tekrarı bakiyeyi ikinci kez değiştirmez ve ilk sonucu döndürür (`duplicate: true`); bu kartta başka bir işlem için ya da başka bir gövdeyle (başka tutar, şube, sayı, not) ya da **başka bir kartta** kullanılmış bir anahtar `422 IDEMPOTENCY_KEY_REUSED` alır ve hiçbir şey yazılmaz (anahtar kimliğindir, kartın değil). Yanıt kartın türüne göre iki biçimdedir: bakiyeli kartlarda `{ balance, duplicate, detail?, promotion? }`, kupon ve indirim kartında (`use`) `{ status, duplicate, uses, usesLeft }`. `reference` (isteğe bağlı, en fazla 80 karakter) fiş numarasıdır: kaydın notuna yazılır ve bir harcamayı, ödülü ya da kullanımı `POST /v1/passes/{serial}/actions/reverse` ile geri alırken işlemi bulur. `currency` (isteğe bağlı) verilirse kartın para birimiyle karşılaştırılır (`422 CURRENCY_MISMATCH`). Şube işletmenizin silinmemiş bir şubesi olmalıdır (`404 LOCATION_NOT_FOUND`). Salt-okunur hesapta da çalışır: mevcut kartlar çalışmaya devam eder.
      * | action | kart | gerekli alan |
      * |---|---|---|
      * | `earn-stamps` | damga | `count` (varsayılan 1) |
@@ -88,7 +88,7 @@ export class RewloyMethods {
     /**
      * Satışı karta yaz
      *
-     * Kasada ya da kendi yazılımınızda tamamlanan bir satışı karta yazar: ne yazılacağına kartın türü ve programın kendi kuralı karar verir, entegrasyonun türü bilmesi gerekmez (ADR 177). `amountMinor` ödenen toplamdır, **kartın para biriminde** (programın para birimi: cashback ve hediye kartında programın kendi para birimi, öteki türlerde işletmeninki; `GET /v1/passes/{serial}` → `currency`) ve kuruş cinsinden; başka para birimi kabul edilmez ve çevrilmez. `currency` gönderirseniz Rewloy onu kartın para birimiyle karşılaştırır ve farklıysa `422 CURRENCY_MISMATCH` ile hiçbir şey yazmaz.
+     * Kasada ya da kendi yazılımınızda tamamlanan bir satışı karta yazar: ne yazılacağına kartın türü ve programın kendi kuralı karar verir, entegrasyonun türü bilmesi gerekmez. `amountMinor` ödenen toplamdır, **kartın para biriminde** (programın para birimi: cashback ve hediye kartında programın kendi para birimi, öteki türlerde işletmeninki; `GET /v1/passes/{serial}` → `currency`) ve kuruş cinsinden; başka para birimi kabul edilmez ve çevrilmez. `currency` gönderirseniz Rewloy onu kartın para birimiyle karşılaştırır ve farklıysa `422 CURRENCY_MISMATCH` ile hiçbir şey yazmaz.
      * | kart | satış ne yazar | `applied` |
      * |---|---|---|
      * | damga | 1 damga (kasa kampanyası katlar) | `stamps` |
@@ -98,10 +98,11 @@ export class RewloyMethods {
      * | hediye kartı, kupon, indirim | hiçbir şey (harcamak ve kullanmak `POST /v1/passes/{serial}/actions` ile) | `none` |
      *
      * Hiçbir şey yazılmadıysa yanıt yine 200'dür, `applied: "none"` ve nedeni `reason`: `below_minimum` (tutar bir puan ya da bir kuruş birikim üretmiyor; `amountMinor: 0` dahil), `visit_already_counted` (VIP: bu ziyaret penceresinde ziyaret zaten sayıldı), `card_full` (damga: kart dolu ve program ödülden sonra damga biriktirmiyor; önce ödülü kullanın), `type_does_not_earn`. Damga ve VIP, `amountMinor: 0` olsa da ziyareti sayar.
-     * - **Idempotency-Key zorunludur**: 8–64 karakter ve bu kimlik için **kalıcı olarak tekil**; defter anahtarları hiç silinmez. Fiş numarası tek başına anahtar olamaz: ÖKC fiş numaraları Z raporundan sonra yeniden başlar. Kasa + Z no + fiş no birleşimi (ör. `kasa3-z0187-fis0042`) ya da satışla birlikte saklanıp tekrarda yeniden gönderilen bir UUID kullanın. Aynı anahtarla **aynı isteğin** tekrarı ikinci kez yazmaz: `duplicate: true`, `credited` ilk isteğin yazdığı, `balance` kartın şimdiki bakiyesi. Aynı anahtar başka bir gövdeyle (başka `amountMinor`, `locationId`, `reference` ya da `currency`) `422 IDEMPOTENCY_KEY_REUSED` alır ve hiçbir şey yazılmaz: satış sessizce kaybolmaz. Anahtar `POST /v1/passes/{serial}/actions` ile aynı alandadır: orada bu kartta kullanılmış bir anahtar da `422 IDEMPOTENCY_KEY_REUSED` alır. Hiçbir şey yazmayan bir satış anahtarı bağlamaz.
+     * - **Idempotency-Key zorunludur**: 8–64 karakter ve bu kimlik için **kalıcı olarak tekil**; defter anahtarları hiç silinmez. Fiş numarası tek başına anahtar olamaz: ÖKC fiş numaraları Z raporundan sonra yeniden başlar. Kasa + Z no + fiş no birleşimi (ör. `kasa3-z0187-fis0042`) ya da satışla birlikte saklanıp tekrarda yeniden gönderilen bir UUID kullanın. Aynı anahtarla **aynı isteğin** tekrarı ikinci kez yazmaz: `duplicate: true`, `credited` ilk isteğin yazdığı, `balance` kartın şimdiki bakiyesi. Aynı anahtar başka bir gövdeyle (başka `amountMinor`, `locationId`, `reference` ya da `currency`) `422 IDEMPOTENCY_KEY_REUSED` alır ve hiçbir şey yazılmaz: satış sessizce kaybolmaz. Anahtar `POST /v1/passes/{serial}/actions` ile aynı alandadır: orada bu kartta kullanılmış bir anahtar da `422 IDEMPOTENCY_KEY_REUSED` alır. Anahtar **kimliğindir, kartın değil**: başka bir kartta bir şey yazmış bir anahtar bu kartta da `422 IDEMPOTENCY_KEY_REUSED` alır (yanıt öteki kartı söylemez): yanlış karta okutulan fiş, doğru karta aynı anahtarla yazılamaz; önce yanlış karttaki satışı geri alın (`sale/reverse`), sonra doğru karta yeni bir anahtarla yazın. Hiçbir şey yazmayan bir satış anahtarı bağlamaz. Anahtar yalnız yazdırılabilir ASCII karakterler taşır (`400 VALIDATION`).
+     * - **Çevrimdışı kasa (`occurredAt`):** bağlantısı kopan kasa satışları kendi kuyruğunda tutar ve bağlantı gelince sırayla gönderir. Her satışı kuyruğa **anahtarıyla birlikte** yazın (kasa + Z no + fiş no) ve gönderirken aynı anahtarı kullanın: kayıp bir yanıttan sonra tekrar ikinci kez yazmaz. `occurredAt` satışın olduğu andır: VIP ziyareti o ana göre sayılır (o anın ziyaret penceresinde zaten sayılmış bir ziyaret varsa `applied: "none"`, `visit_already_counted`), kasa kampanyası o anda çalışan kampanyadır. Gelecekte olamaz (2 dakika saat farkı kabul edilir), en fazla 72 saat geriye gider ve kartın verildiği andan önce olamaz (`400 VALIDATION`): daha eski bir kuyruğu elle düzeltin. Kasa kampanyası, o anda çalışan ve o anda zaten açılmış olandır: sonradan geçmiş bir başlangıçla açılan kampanya kuyruktaki satışı katlamaz. Kartın son kullanım tarihi ve şube kuralı gönderildiği ana göre denetlenir. Kaydın kendi zamanı (`at`, işlem kaydı ve döküm) yazıldığı andır; olduğu an kayıtta ayrıca durur (işlem kaydında `occurredAt`, webhook'ta `occurredAt`).
      * - **`reference`** (isteğe bağlı, en fazla 80 karakter): fiş numarası buraya yazılır. Defter kaydının notuna yazılır: müşterinin geçmişinde (VIP ziyaretleri hariç; onlar ziyaret olarak görünür) ve işlem dökümünün `Not` sütununda görünür. Müşterinin kişisel bilgisini yazmayın.
      * - Şube kuralları ve kasa kampanyaları `actions` ile aynıdır: kart bu şubede geçerli değilse `409 WRONG_LOCATION`, kampanya `promotion` ile döner. Salt-okunur hesapta da çalışır.
-     * - **`locationId` isteğe bağlıdır** (ADR 182): verilmezse satış bir şubeye yazılmaz (online mağaza gibi). O zaman şube kuralı ve kasa kampanyası uygulanmaz (e-ticaret siparişleri gibi), kayıtta şube boş kalır ve kimliğin **her şubede** `scan.use` yetkisi olmalıdır (yoksa `403 FORBIDDEN`); bir şubenin kasası şubesini gönderir. Yeni bir şube açmak gerekmez, hiçbir şey ücretlendirilmez.
+     * - **`locationId` isteğe bağlıdır**: verilmezse satış bir şubeye yazılmaz (online mağaza gibi). O zaman şube kuralı ve kasa kampanyası uygulanmaz (e-ticaret siparişleri gibi), kayıtta şube boş kalır ve kimliğin **her şubede** `scan.use` yetkisi olmalıdır (yoksa `403 FORBIDDEN`); bir şubenin kasası şubesini gönderir. Yeni bir şube açmak gerekmez, hiçbir şey ücretlendirilmez.
      * - **Geri almak:** `POST /v1/passes/{serial}/sale/reverse` satışın yazdığını bir kez geri alır.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
@@ -120,12 +121,13 @@ export class RewloyMethods {
     /**
      * Satışı geri al
      *
-     * İade ya da iptal edilen bir satışın karta yazdığını geri alır (ADR 182): o satışın yazdığı damga, puan, ziyaret ya da cashback'in tamamı, kasa kampanyasının katladığı dahil. Defter düzeltilmez; karta yeni bir düzeltme kaydı (`adjust`) yazılır ve müşterinin cüzdanı güncellenir.
-     * - **Hangi satış:** `saleKey`, satışı yazarken gönderdiğiniz `Idempotency-Key`'dir (aynı kimlikle; anahtarlar kimlik başına tutulur), ya da `reference`, satışın `reference`'ı (bu kartta yalnız bir satışta varsa; birden çoksa `409 SALE_AMBIGUOUS`, `saleKey` gönderin). İkisinden yalnız biri. `recordSale` ile ya da kazandıran bir kasa işlemiyle (`earn-stamps`, `earn-points`, `visit`, `accrue`) yazılan kayıtlar geri alınır; harcama, ödül ve kullanım geri alınmaz.
+     * İade ya da iptal edilen bir satışın karta yazdığını geri alır: o satışın yazdığı damga, puan, ziyaret ya da cashback'in tamamı, kasa kampanyasının katladığı dahil. Defter düzeltilmez; karta yeni bir düzeltme kaydı (`adjust`) yazılır ve müşterinin cüzdanı güncellenir.
+     * - **Hangi satış:** `saleKey`, satışı yazarken gönderdiğiniz `Idempotency-Key`'dir (aynı kimlikle; anahtarlar kimlik başına tutulur), ya da `reference`, satışın `reference`'ı (**aynı kimliğin** bu karttaki satışları arasında yalnız birinde varsa; birden çoksa `409 SALE_AMBIGUOUS`, `saleKey` gönderin). İkisinden yalnız biri. `recordSale` ile ya da kazandıran bir kasa işlemiyle (`earn-stamps`, `earn-points`, `visit`, `accrue`) yazılan kayıtlar geri alınır; harcama, ödül ve kullanım burada değil, `POST /v1/passes/{serial}/actions/reverse` ile geri alınır.
      * - **Bir kez:** bir satış bir kez geri alınır, kim isterse istesin; tekrar `200` ve `duplicate: true` döner, hiçbir şey yazılmaz. Bu yüzden `Idempotency-Key` gerekmez.
      * - **Ne geri alınabilir:** kartın bakiyesi satışın yazdığını hâlâ tutuyorsa. Kazanılan kullanıldıysa (damgalar ödüle, puanlar ödüle ya da harcamaya, cashback harcamaya ya da online bir siparişe gittiyse) bakiye yetmez: `409 SALE_ALREADY_SPENT`, `details: { credited, balance }`, hiçbir şey yazılmaz. Kısmi geri alma yoktur; bakiye eksiye düşmez. Hiçbir şey yazmamış bir satış (`applied: "none"`), hediye kartı, kupon ve indirim kartı `404 SALE_NOT_FOUND`.
      * - **Kim geri alabilir:** satışın yapıldığı yerde kart işleyebilen: kimliğin **satışın şubesinde** `scan.use` yetkisi olmalıdır; şubesiz (online) bir satış için, onu yazarken olduğu gibi, her şubede (`403 FORBIDDEN`). `locationId` isteğe bağlıdır: geri almanın yapıldığı şube, düzeltme kaydına yazılır; verilirse işletmenin silinmemiş bir şubesi olmalı ve kimliğin orada da `scan.use` yetkisi olmalıdır. Geri alma bir ziyaret ya da okutma sayılmaz. Kapanmış ya da süresi dolmuş kartta da çalışır. Salt-okunur hesapta da çalışır.
      * - **`reference` ile** yalnız satışı yazan çağrının gönderdiği `reference` eşleşir (kasa kampanyasının nota eklediği ad değil); 1.0.5'ten önce yazılmış satışlar yalnız `saleKey` ile bulunur.
+     * - **VIP ziyareti** geri alınınca ziyaret penceresi yeniden açılır: iptal edilip yeniden kesilen fişin satışı ziyareti yeniden sayar.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -140,6 +142,30 @@ export class RewloyMethods {
     reverseSale(args) {
         return this._call('reverseSale', args);
     }
+    /**
+     * Kasa işlemini geri al
+     *
+     * Yanlışlıkla yapılan ya da iptal edilen bir harcamayı, ödülü veya kullanımı geri alır: `spend` (hediye kartı, cashback), `spend-points`, `redeem-stamps`, `redeem-reward` ya da `use` (kupon, indirim kartı) ile alınanın tamamı geri verilir — bakiye, puan ya da damgalar karta döner, ödül yeniden hazır olur, kuponun ya da indirim kartının kullanım hakkı geri gelir, harcamayla kapanan hediye kartı ya da kullanımla kapanan kupon yeniden açılır. Defter düzeltilmez: karta yeni bir düzeltme kaydı (`adjust`) yazılır (kuponda kullanım kaydı geri alındı olarak işaretlenir) ve müşterinin cüzdanı güncellenir.
+     * - **Hangi işlem:** `actionKey`, işlemi yaparken (`POST /v1/passes/{serial}/actions`) gönderdiğiniz `Idempotency-Key`'dir, ya da `reference`, işlemin `reference`'ı (bu kartta bu kimliğin yalnız bir işleminde varsa; birden çoksa `409 ACTION_AMBIGUOUS`). İkisinden yalnız biri. **Yalnız aynı kimliğin** işlemleri bulunur: başka bir anahtarın, panelin tarayıcısının ya da bir e-ticaret siparişinin işlemi `404 ACTION_NOT_FOUND`. Kazanımlar (`earn-stamps`, `earn-points`, `visit`, `accrue`) burada değil, `POST /v1/passes/{serial}/sale/reverse` ile geri alınır.
+     * - **Online ödeme:** ödeme adımında çekilen bir tutar burada geri alınmaz; onun kendi iadesi vardır (`POST /v1/shops/{id}/orders/{orderId}/refund`).
+     * - **Bir kez:** bir işlem bir kez geri alınır, kim, kaç kez isterse istesin; tekrar `200` ve `duplicate: true` döner, hiçbir şey yazılmaz. Bu yüzden `Idempotency-Key` gerekmez. Geri alınan işlemin anahtarı yanmıştır: aynı anahtarla gelen istek ilk sonucu döndürür (`duplicate: true`), yeni bir işlem için yeni anahtar gönderin.
+     * - **Geri alınamayanlar:** kart iptal edilmiş ya da başka bir nedenle kapanmışsa, ya da kartın müşterisi silinmiş, programı arşivde ya da müşterisi engellenmişse (`details.reason: "card_closed"`), süresi dolmuşsa (`"card_expired"`), ya da damga ödülü geri verildiğinde kart programın en çok damgasını aşacaksa ve program ödülden sonra damga biriktirmiyorsa (`"stamps_do_not_fit"`): `409 ACTION_NOT_REVERSIBLE`, hiçbir şey yazılmaz. Harcamayla ya da kullanımla kapanan kart bu kurala girmez: geri alma onu yeniden açar.
+     * - **Kim geri alabilir:** satışın geri alınmasındaki kural: kimliğin **işlemin yapıldığı şubede** `scan.use` yetkisi olmalıdır (`403 FORBIDDEN`). `locationId` isteğe bağlıdır: geri almanın yapıldığı şube; verilirse işletmenin silinmemiş bir şubesi olmalı ve kimliğin orada da `scan.use` yetkisi olmalıdır. Geri alma bir ziyaret ya da okutma sayılmaz. Salt-okunur hesapta da çalışır.
+     * - **Webhook:** `pass.activity`, `kind: "adjust"`, `reason: "action_reversed"`, `undone` (`spend`, `redeem` ya da `use`), geri verilen `delta` (pozitif) ve `unit`; işlem `reference` taşıyorsa o da.
+     *
+     * **Kimlik:** API anahtarı, ekip oturumu.
+     *
+     * **Yetki:** `scan.use` — Tarayıcıyı kullanma.
+     *
+     * Salt-okunur hesapta da çalışır.
+     *
+     * `POST /v1/passes/{serial}/actions/reverse`
+     *
+     * @see {@link https://rewloy.com/gelistiriciler/api#op-reverseAction | API referansı}
+     */
+    reverseAction(args) {
+        return this._call('reverseAction', args);
+    }
     // ------------------------------------------------------------ Katılım
     /**
      * Katılım formu
@@ -312,7 +338,7 @@ export class RewloyMethods {
      * - `previousToken`: bu kurulumun daha önceki `rwh_` oturumu (süresi dolmuş olsa da). Adres ya da numara o hesabınsa adres ve numara başına sınırlar uygulanmaz, böylece başkaları sizin kodlarınızı tüketemez. Çıkış yapılmış ya da kaldırılmış bir oturum bir şey kanıtlamaz.
      * - `deviceName`: açılacak oturumun Cihazlarım'daki adı.
      * - **Idempotency-Key** (isteğe bağlı, önerilir; 8–64 karakter, her yeni istek için yeni bir UUID): aynı anahtar ve aynı gövdeyle tekrar yeni kod GÖNDERMEZ, ilk yanıtı (aynı `request`) `Idempotent-Replayed: true` ile döndürür ve sınırlardan düşmez — bağlantısı kopan uygulama güvenle yineler. Aynı anahtar başka bir gövdeyle `422 IDEMPOTENCY_KEY_REUSED`; ilk istek sürerken `409 IDEMPOTENCY_IN_PROGRESS` (bir şey gönderilmez). Yanıt şifreli saklanır, 7 gün tekrar edilir; kodun kendisi 15 dakika geçerlidir, yeni kod için yeni anahtar gönderin. Oturumsuz çağrıda anahtar istemcinin IP adresine bağlıdır. Başlık yoksa her çağrı yeni bir kod ve yeni bir `request` demektir.
-     * - **Sözleşme değişikliği (ADR 150):** `request` yeni. E-postadaki bağlantı artık oturumu tek başına açmaz; bağlantıyı uygulamanız yakalarsa `linkToken` olarak yine aynı `request` ile gönderin.
+     * - **Sözleşme değişikliği:** `request` yeni. E-postadaki bağlantı artık oturumu tek başına açmaz; bağlantıyı uygulamanız yakalarsa `linkToken` olarak yine aynı `request` ile gönderin.
      *
      * **Kimlik:** kimlik gerekmez.
      *
@@ -514,7 +540,7 @@ export class RewloyMethods {
     /**
      * Davet
      *
-     * Davet e-postasındaki bağlantının son parçası (`/davet/<code>`): hangi işletme, hangi adres. Adresin Rewloy hesabı olup olmadığını söylemez (bağlantı daveti yapanda da vardır, ADR 181): hesabı olan kişi o hesapla giriş yapıp oturumuyla kabul eder, olmayan şifre belirleyerek.
+     * Davet e-postasındaki bağlantının son parçası (`/davet/<code>`): hangi işletme, hangi adres. Adresin Rewloy hesabı olup olmadığını söylemez (bağlantı daveti yapanda da vardır): hesabı olan kişi o hesapla giriş yapıp oturumuyla kabul eder, olmayan şifre belirleyerek.
      *
      * **Kimlik:** kimlik gerekmez.
      *
@@ -528,7 +554,7 @@ export class RewloyMethods {
     /**
      * Daveti kabul et
      *
-     * Koltuk ve roller verilir — daveti yapanın o anki yetkileriyle yeniden denetlenerek — ve oturum döner. Daveti yapan işletme sahiplerine bildirilir. **Davet hiçbir zaman mevcut bir hesabın şifresini sormaz** (bağlantı daveti yapanda da vardır; ADR 181):
+     * Koltuk ve roller verilir — daveti yapanın o anki yetkileriyle yeniden denetlenerek — ve oturum döner. Daveti yapan işletme sahiplerine bildirilir. **Davet hiçbir zaman mevcut bir hesabın şifresini sormaz** (bağlantı daveti yapanda da vardır):
      * - **Adresin hesabı varsa:** kişi o hesapla girer (`POST /v1/auth/login`) ve bu çağrıyı kendi `rws_` oturumuyla, gövdesiz yapar; yanıt aynı oturumu güncel işletmeleriyle döndürür. Başka bir adresin oturumu `403 INVITE_OTHER_ACCOUNT`. Oturumsuz çağrı, şifreyle de olsa, `409 INVITE_SIGN_IN`.
      * - **Hesabı yoksa:** oturumsuz, `password` (en az 10 karakter) ile hesap açılır ve yeni oturum döner. Adres davetle doğrulanmış sayılmaz: doğrulama bağlantısı e-postayla gider (kayıttaki gibi).
      * - IP başına 15 dakikada 20 deneme.
@@ -977,7 +1003,7 @@ export class RewloyMethods {
     /**
      * Müşteriler
      *
-     * Kimliğin şube kapsamındaki müşteriler, kartlarıyla. Paneldeki bütün süzgeçler burada da vardır. Bir müşteri, kapsamınızdaki bir şubede kartı ya da ziyareti varsa görünür. Her müşterinin adresleri ve numaraları `identifiers` içinde, durumlarıyla: doğrulanmış olanı yalnız müşteri değiştirir; API bir adresi ya da numarayı değiştirmez (ADR 168).
+     * Kimliğin şube kapsamındaki müşteriler, kartlarıyla. Paneldeki bütün süzgeçler burada da vardır. Bir müşteri, kapsamınızdaki bir şubede kartı ya da ziyareti varsa görünür. Her müşterinin adresleri ve numaraları `identifiers` içinde, durumlarıyla: doğrulanmış olanı yalnız müşteri değiştirir; API bir adresi ya da numarayı değiştirmez.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -993,7 +1019,7 @@ export class RewloyMethods {
     /**
      * Müşteriler, kart kart
      *
-     * Aynı süzgeçlerle, her satırda bir kart (panelde "kart kart" görünüm). `q` bir kişiyi bulur ve kişinin bütün kartları gelir; `q` bir kart numarası (ya da başı, en az 4 karakter, tire ve büyük-küçük harf önemsiz) olarak da okunur: numarası onunla başlayan kart `matched: true` taşır ve listenin başına gelir, tam eşleşen en başa (ADR 182). Bir kartı numarasıyla okumak için `GET /v1/passes/{serial}` daha doğrudur.
+     * Aynı süzgeçlerle, her satırda bir kart (panelde "kart kart" görünüm). `q` bir kişiyi bulur ve kişinin bütün kartları gelir; `q` bir kart numarası (ya da başı, en az 4 karakter, tire ve büyük-küçük harf önemsiz) olarak da okunur: numarası onunla başlayan kart `matched: true` taşır ve listenin başına gelir, tam eşleşen en başa. Bir kartı numarasıyla okumak için `GET /v1/passes/{serial}` daha doğrudur.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -1057,7 +1083,7 @@ export class RewloyMethods {
     /**
      * Müşteriyi engelle
      *
-     * Müşterinin e-postasını ve doğrulanmış numaralarını engelli listesine ekler (ADR 168): bunlardan biriyle yeni kart alınamaz; Rewloy Cüzdan'da aynı hesap, bunlardan birini tuttuğu sürece, başka bir adresi ya da numarasıyla da alamaz. Yazılan (doğrulanmamış) telefon engellenmez: kimse kanıtlamadı, başkasının olabilir. `endCards: true` ile açık kartları da kapatılır (her cüzdana bir kez haber gider). Neden kayda geçer; adres ya da numara değil, özeti saklanır. Ne engellendiyse `entries` içinde; kaldırmak: `DELETE /v1/blocked-emails/{hash}` ya da `DELETE /v1/blocked-phones/{hash}`.
+     * Müşterinin e-postasını ve doğrulanmış numaralarını engelli listesine ekler: bunlardan biriyle yeni kart alınamaz; Rewloy Cüzdan'da aynı hesap, bunlardan birini tuttuğu sürece, başka bir adresi ya da numarasıyla da alamaz. Yazılan (doğrulanmamış) telefon engellenmez: kimse kanıtlamadı, başkasının olabilir. `endCards: true` ile açık kartları da kapatılır (her cüzdana bir kez haber gider). Neden kayda geçer; adres ya da numara değil, özeti saklanır. Ne engellendiyse `entries` içinde; kaldırmak: `DELETE /v1/blocked-emails/{hash}` ya da `DELETE /v1/blocked-phones/{hash}`.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -1153,7 +1179,7 @@ export class RewloyMethods {
     /**
      * Engellenen numaralar
      *
-     * Yeniden eskiye (ADR 168). Numaralar anahtarlı özet ve maskeli ipucuyla görünür; bir numaranın listede olup olmadığını `GET /v1/blocked-phones/check` ile sorun.
+     * Yeniden eskiye. Numaralar anahtarlı özet ve maskeli ipucuyla görünür; bir numaranın listede olup olmadığını `GET /v1/blocked-phones/check` ile sorun.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -1238,7 +1264,7 @@ export class RewloyMethods {
      * | tür | alanlar |
      * |---|---|
      * | hediye kartı | `valueMinor` zorunlu (100 – 100.000.000 kuruş); kullanım her zaman sınırsız, bakiye bitene kadar |
-     * | kupon | ya `offerText` (ör. "1 tatlı") ya `valueMinor` (100 – 10.000.000 kuruş indirim); `usage`; isteğe bağlı `onlineValue` (online mağazadaki değeri: `{ kind: amount, value: kuruş }` ya da `{ kind: percent, value: 1–100 }`, ADR 179) |
+     * | kupon | ya `offerText` (ör. "1 tatlı") ya `valueMinor` (100 – 10.000.000 kuruş indirim); `usage`; isteğe bağlı `onlineValue` (online mağazadaki değeri: `{ kind: amount, value: kuruş }` ya da `{ kind: percent, value: 1–100 }`) |
      * | indirim kartı | `percent` (yoksa programın oranı); `usage` |
      *
      * `usage`: `once` tek kullanım, `limited` + `usageLimit` (2–1000), `unlimited`. `validUntil` bir gün (YYYY-AA-GG) ise o günün sonuna kadar (Türkiye saati) geçerlidir. Başka türün alanı reddedilir. Planda `instruments` özelliği gerekir.
@@ -1273,7 +1299,7 @@ export class RewloyMethods {
     /**
      * Koddan verilen kartlar
      *
-     * Yeniden eskiye; `status` ile süzülür. Hediye kartında `balance` kalan tutardır (kuruş). Kimliğin `customers.read` yetkisi de varsa kartı alanın bu işletmedeki adresleri ve numaraları `identifiers` içinde gelir, durumlarıyla: numarayla alınan kartın kişisi numarasıyla tanınır (ADR 168). Bu yetki yoksa ya da kişi kimliğin şube kapsamı dışındaysa `identifiers` gelmez: müşterinin iletişim bilgisi müşteri okuma yetkisiyle görülür.
+     * Yeniden eskiye; `status` ile süzülür. Hediye kartında `balance` kalan tutardır (kuruş). Kimliğin `customers.read` yetkisi de varsa kartı alanın bu işletmedeki adresleri ve numaraları `identifiers` içinde gelir, durumlarıyla: numarayla alınan kartın kişisi numarasıyla tanınır. Bu yetki yoksa ya da kişi kimliğin şube kapsamı dışındaysa `identifiers` gelmez: müşterinin iletişim bilgisi müşteri okuma yetkisiyle görülür.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -1866,7 +1892,7 @@ export class RewloyMethods {
     /**
      * Analitik
      *
-     * Son 7, 30 ya da 90 günün göstergeleri: açık kartlar, yeni kartlar, ziyaretler, ziyaret eden kişiler ve bunlardan dönen (2+ ziyaret), ödüller; günlük ziyaretler; haftalık yeni ve dönen ziyaretçiler; program başına kart → kullanım → ödül hunisi; şubeler; en sık gelen müşteriler (yalnız `customers.read` ile). Apple Cüzdan'daki kartlar ve konum hatırlatması taşıyanlar. `programId` ile tek bir programın sayıları (ADR 178); kapsamı programlarla sınırlı bir kimlik yalnız kendi programlarını görür. Bir mağaza eklentisinin anahtarına müşteri adı gelmez.
+     * Son 7, 30 ya da 90 günün göstergeleri: açık kartlar, yeni kartlar, ziyaretler, ziyaret eden kişiler ve bunlardan dönen (2+ ziyaret), ödüller; günlük ziyaretler; haftalık yeni ve dönen ziyaretçiler; program başına kart → kullanım → ödül hunisi; şubeler; en sık gelen müşteriler (yalnız `customers.read` ile). Apple Cüzdan'daki kartlar ve konum hatırlatması taşıyanlar. `programId` ile tek bir programın sayıları; kapsamı programlarla sınırlı bir kimlik yalnız kendi programlarını görür. Bir mağaza eklentisinin anahtarına müşteri adı gelmez.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -1882,7 +1908,7 @@ export class RewloyMethods {
     /**
      * İşlem kaydı: kasa
      *
-     * Kartlarda yapılan her işlem, yeniden eskiye: damga, puan, ödül, harcama, yükleme, ziyaret, kupon kullanımı… kim (ekip üyesi, API anahtarı ya da sistem), nerede, hangi kart. `day` işletmenin takvim günüdür. Planda `auditlog` özelliği gerekir. `limit` en fazla 100. Kapsamı programlarla sınırlı bir kimlik (ör. mağaza eklentisinin anahtarı) yalnız kendi programlarının kartlarını görür (ADR 178). Bir mağaza eklentisinin anahtarına kişisel veri gelmez: ekip üyesi `actor` yerine "ekip üyesi" yazar, `personId` null'dır.
+     * Kartlarda yapılan her işlem, yeniden eskiye: damga, puan, ödül, harcama, yükleme, ziyaret, kupon kullanımı… kim (ekip üyesi, API anahtarı ya da sistem), nerede, hangi kart. `day` işletmenin takvim günüdür. Planda `auditlog` özelliği gerekir. `limit` en fazla 200. `at` Rewloy'nun kaydı yazdığı andır (sıra da ona göredir); sonradan yazılan bir satışın olduğu an `occurredAt`'tadır. Bir geri alma `kind: "adjust"` olarak görünür (kuponun ya da indirim kartının geri verilen kullanımı: `delta: 1`, `unit: null`). Kapsamı programlarla sınırlı bir kimlik (ör. mağaza eklentisinin anahtarı) yalnız kendi programlarının kartlarını görür. Bir mağaza eklentisinin anahtarına kişisel veri gelmez: ekip üyesi `actor` yerine "ekip üyesi" yazar, `personId` null'dır.
      *
      * **Kimlik:** API anahtarı, ekip oturumu.
      *
@@ -1948,7 +1974,7 @@ export class RewloyMethods {
      *
      * Kişisel verinin sistemden çıktığı an; bu yüzden **yalnız ekip oturumuyla** ve oturumu açan kişinin şifresiyle (`password`) yapılır — API anahtarıyla yapılamaz. Saatte en fazla 20; her biri kayda geçer (satır sayısı, kapsam, dönem).
      * - `kind: customers` müşteri listesi (`customers.export`), `kind: ledger` son `days` günün işlemleri (`analytics.export`, 1–366).
-     * - Müşteri listesinde e-posta ve telefon durumlarıyla ayrı sütunlardadır (ADR 168): `E-posta doğrulandı` (evet/hayır: müşteri adresi kendi koduyla doğruladı mı), `Doğrulanmış telefon` (yalnız müşterinin kendi koduyla doğruladığı numaralar), `Yazılan telefon (doğrulanmamış)` (formda, kasada ya da API ile yazılan; doğrulanmış bir numarayla aynıysa boş). Numaralar 0532 123 45 67 biçiminde.
+     * - Müşteri listesinde e-posta ve telefon durumlarıyla ayrı sütunlardadır: `E-posta doğrulandı` (evet/hayır: müşteri adresi kendi koduyla doğruladı mı), `Doğrulanmış telefon` (yalnız müşterinin kendi koduyla doğruladığı numaralar), `Yazılan telefon (doğrulanmamış)` (formda, kasada ya da API ile yazılan; doğrulanmış bir numarayla aynıysa boş). Numaralar 0532 123 45 67 biçiminde.
      * - Türkçe Excel için: UTF-8 BOM, `;` ayraç, CRLF. `=`, `+`, `-`, `@` ile başlayan hücreler formül olarak çalışmasın diye `'` ile başlar.
      *
      * **Kimlik:** ekip oturumu.
@@ -2370,7 +2396,7 @@ export class RewloyMethods {
      * - Kod **yalnız bu yanıtta** görünür; Rewloy yalnız özetini saklar. 15 dakika geçerlidir.
      * - Kodu bir kişi alır (ekip oturumu; bir anahtar anahtar üretemez), `apikeys.manage`, kartın programında mağaza bağlantısı yetkisi ve — elle anahtar oluştururken olduğu gibi — `team.manage` ile (anahtarın yetkisi o kişiden verilen bir roldür; kişi E-ticaret rolünün yetkilerini tüm şubelerde taşımalıdır), `api` ve `ecommerce` özellikli bir planda. Kod bir API anahtarı ürettiği için kişinin şifresi yeniden istenir (`password`), anahtar oluştururken olduğu gibi. Bağlantı ve anahtar, kod kullanıldığı anda bu kişinin yetkileriyle kurulur: kişi o arada yetkisini kaybettiyse hiçbir şey kurulmaz.
      * - Kural alanları `POST /v1/shops` ile aynıdır. En fazla 5 bağlantı ve aynı anda en fazla 5 bekleyen kod.
-     * - **Eklentinin yetkileri** (ADR 178), kodu alan kişi seçer; sonra bağlantının sayfasından ya da `PUT /v1/shops/{id}/plugin-abilities` ile değişir:
+     * - **Eklentinin yetkileri**, kodu alan kişi seçer; sonra bağlantının sayfasından ya da `PUT /v1/shops/{id}/plugin-abilities` ile değişir:
      *   - `view` (Görüntüleme; bu çağrıda gönderilmezse kapalı, panelin formunda işaretli gelir): bağlantının programında `passes.read` ve `analytics.read` — kartın durumu (`GET /v1/passes/{serial}`), programın sayıları (`GET /v1/analytics?programId=`) ve kartlardaki son işlemler (`GET /v1/activity`). Müşterinin adı, e-postası ya da telefonu gelmez; ekip üyesinin e-postası da.
      *   - `tillLocationId` (Kasa, varsayılan kapalı): bu tek şubede ve bağlantının programında `scan.use` — `GET /v1/passes/{serial}/till`, `POST …/sale`, `POST …/actions`. Hediye kartı yüklemek (`load`) yine `instruments.issue` ister ve verilmez. Kapalı başlar: açıkken WooCommerce'i yönetebilen herkes o şubede müşterilerin bakiyesini harcatabilir.
      *   - Kişi bu yetkileri verebilmelidir (`team.manage` ve alt küme kuralı: Görüntüleme yetkilerini tüm şubelerde, `scan.use`'u o şubede taşımalı).
@@ -2407,7 +2433,7 @@ export class RewloyMethods {
      *
      * Mağaza eklentisinin tek adımı: paneldeki bağlantı kodunu (`rwc_…`) verir, karşılığında **bir kez** şunları alır: bağlantı (`shop`), bağlantının sırrı (`secret`, WooCommerce webhook'una yazılır) ve yalnız bu bağlantıya bağlı API anahtarı (`apiKey.token`). Kimlik istemez; kod kimliktir.
      * - Kod **tek kullanımlıktır**: ikinci kez, süresi dolmuşken ya da iptal edilmişken aynı yanıtı alır: `404 CONNECT_TOKEN_INVALID` (hangisi olduğu söylenmez). Kurulum yarıda reddedilirse (ör. 5 bağlantı sınırı) kod harcanmaz.
-     * - Anahtar "E-ticaret" rolündedir ve bağlantının programıyla sınırlıdır: kartları ve ayarları görür, yalnız kendi bağlantısını görür ve yönetir, o programdan kart verir. Kodu alan kişi Görüntüleme ve Kasa'yı seçtiyse anahtar onları da alır (`apiKey.abilities`, ADR 178); `GET /v1/me` her an yeniden söyler. Bağlantı silinince anahtar da iptal edilir. Test ortamının kodu `rwk_test_` anahtarı verir (`mode`).
+     * - Anahtar "E-ticaret" rolündedir ve bağlantının programıyla sınırlıdır: kartları ve ayarları görür, yalnız kendi bağlantısını görür ve yönetir, o programdan kart verir. Kodu alan kişi Görüntüleme ve Kasa'yı seçtiyse anahtar onları da alır (`apiKey.abilities`); `GET /v1/me` her an yeniden söyler. Bağlantı silinince anahtar da iptal edilir. Test ortamının kodu `rwk_test_` anahtarı verir (`mode`).
      * - `shopName` anahtarın panelde görünen adına eklenir ("WooCommerce · …"). IP başına 10 dakikada 20 istek.
      *
      * **Kimlik:** kimlik gerekmez.
@@ -2422,10 +2448,10 @@ export class RewloyMethods {
     /**
      * Eklentinin yetkilerini değiştir
      *
-     * Bağlantı koduyla kurulmuş bir bağlantının eklenti anahtarının bağlantı dışında yapabildikleri (ADR 178): Görüntüleme (`view`) ve tek bir şubenin Kasası (`tillLocationId`; null = kapalı). Değişiklik mevcut anahtara **hemen** uygulanır; eklentinin yeniden bağlanması gerekmez, eklenti `GET /v1/me` ile okur.
+     * Bağlantı koduyla kurulmuş bir bağlantının eklenti anahtarının bağlantı dışında yapabildikleri: Görüntüleme (`view`) ve tek bir şubenin Kasası (`tillLocationId`; null = kapalı). Değişiklik mevcut anahtara **hemen** uygulanır; eklentinin yeniden bağlanması gerekmez, eklenti `GET /v1/me` ile okur.
      * - Yalnız ekip oturumuyla: bir anahtarın yetkisini değiştirmek, anahtar oluşturmak gibidir. Bağlantının programında `shops.manage` (ya da `apikeys.manage`), ayrıca `apikeys.manage`, `team.manage` ve alt küme kuralı (verilen yetkileri kişi o şubelerde taşımalı) ister; kişinin şifresi (`password`) ve değişikliğin nedeni (`reason`, en fazla 200 karakter, yalnız ekibin gördüğü işlem kaydına yazılır) istenir.
      * - Bağlantıyı eklenti kurmadıysa ya da eklentinin anahtarı iptal edildiyse `409 NO_PLUGIN_KEY`.
-     * - **Eklentinin yetkileri** (ADR 178), kodu alan kişi seçer; sonra bağlantının sayfasından ya da `PUT /v1/shops/{id}/plugin-abilities` ile değişir:
+     * - **Eklentinin yetkileri**, kodu alan kişi seçer; sonra bağlantının sayfasından ya da `PUT /v1/shops/{id}/plugin-abilities` ile değişir:
      *   - `view` (Görüntüleme; bu çağrıda gönderilmezse kapalı, panelin formunda işaretli gelir): bağlantının programında `passes.read` ve `analytics.read` — kartın durumu (`GET /v1/passes/{serial}`), programın sayıları (`GET /v1/analytics?programId=`) ve kartlardaki son işlemler (`GET /v1/activity`). Müşterinin adı, e-postası ya da telefonu gelmez; ekip üyesinin e-postası da.
      *   - `tillLocationId` (Kasa, varsayılan kapalı): bu tek şubede ve bağlantının programında `scan.use` — `GET /v1/passes/{serial}/till`, `POST …/sale`, `POST …/actions`. Hediye kartı yüklemek (`load`) yine `instruments.issue` ister ve verilmez. Kapalı başlar: açıkken WooCommerce'i yönetebilen herkes o şubede müşterilerin bakiyesini harcatabilir.
      *   - Kişi bu yetkileri verebilmelidir (`team.manage` ve alt küme kuralı: Görüntüleme yetkilerini tüm şubelerde, `scan.use`'u o şubede taşımalı).
@@ -2985,8 +3011,8 @@ export class RewloyMethods {
      * Webhook ekle
      *
      * Seçilen olaylar bu adrese imzalı olarak gönderilir; `secret` **yalnız bu yanıtta** döner (imzayı doğrulamak için saklayın). En fazla 10 etkin webhook. Yeni webhook bundan sonraki olayları alır, geçmişi değil.
-     * - **Adres:** herkese açık bir **https** adresi; iç ağ adresleri (localhost, 127.0.0.1, 10.x, 172.16–31.x, 192.168.x…) ve http kabul edilmez (`422 BAD_WEBHOOK_URL`). Kural **test ortamında da aynıdır**: teslimleri Rewloy'un sunucuları yapar ve sizin bilgisayarınıza ulaşamaz. Yerel geliştirmede sunucunuzu bir tünelle açın (ör. `cloudflared tunnel --url http://localhost:3000` ya da `ngrok http 3000`) ve tünelin https adresini verin. Teslim anında adres yeniden çözülür ve denetlenir.
-     * - **API anahtarıyla** (ADR 182): `webhooks.manage` yetkisi taşıyan anahtar webhook ekler, açar, kapatır, deneme olayı gönderir ve teslimleri okur. Anahtar yalnız kendisinin okuyabildiği olayları bir adrese gönderebilir: webhook işletmenin her şubesinin ve her programının olaylarını taşıdığı için anahtarın **her şubede ve her programda** `passes.read` yetkisi olmalıdır (yoksa `403 FORBIDDEN`). Her değişiklik, ekip üyesininki gibi, anahtar adına kaydedilir (`GET /v1/activity/access`). Anahtarın eklediği webhook anahtardan uzun yaşamaz: anahtar kaldırılınca, süresi dolunca ya da yetkisi daralınca kendiliğinden kapanır (`createdByKey`, `disabledReason`).
+     * - **Adres:** herkese açık bir **https** adresi; iç ağ adresleri (localhost, 127.0.0.1, 10.x, 172.16–31.x, 192.168.x…) ve http kabul edilmez (`422 BAD_WEBHOOK_URL`). Kural **test ortamında da aynıdır**: teslimleri Rewloy'un sunucuları yapar ve sizin bilgisayarınıza ulaşamaz. Yerel geliştirmede sunucunuzu bir tünelle açın (ör. `cloudflared tunnel --url http://localhost:3000` ya da `ngrok http 3000`) ve tünelin https adresini verin. Teslim anında adres yeniden çözülür ve denetlenir. Canlı olmayan bir Rewloy kurulumu (geliştirme, staging) http ve iç ağ adreslerini kabul eder; o zaman yanıttaki `warnings` canlı ortamın bu adresi neden reddedeceğini söyler.
+     * - **API anahtarıyla**: `webhooks.manage` yetkisi taşıyan anahtar webhook ekler, açar, kapatır, deneme olayı gönderir ve teslimleri okur. Anahtar yalnız kendisinin okuyabildiği olayları bir adrese gönderebilir: webhook işletmenin her şubesinin ve her programının olaylarını taşıdığı için anahtarın **her şubede ve her programda** `passes.read` yetkisi olmalıdır (yoksa `403 FORBIDDEN`). Her değişiklik, ekip üyesininki gibi, anahtar adına kaydedilir (`GET /v1/activity/access`). Anahtarın eklediği webhook anahtardan uzun yaşamaz: anahtar kaldırılınca, süresi dolunca ya da yetkisi daralınca kendiliğinden kapanır (`createdByKey`, `disabledReason`).
      * - **10 etkin webhook** sınırı işletme başınadır: kişilerin ve bütün anahtarların eklediği etkin webhook'lar birlikte sayılır (`409 LIMIT`).
      *
      * **Kimlik:** ekip oturumu, API anahtarı.
@@ -3017,7 +3043,7 @@ export class RewloyMethods {
     /**
      * Aç ya da kapat
      *
-     * Kapalıyken olaylar gönderilmez; yeniden açılınca açıldığı andan sonraki olaylar gelir ve başarısızlık sayacı sıfırlanır. Bir API anahtarı yalnız olaylarını okuyabildiği bir webhook'u açabilir; yalnız kendi eklediği webhook'ları kapatabilir, başkasınınkini kapatmak için her yerde `passes.read` gerekir (`403 FORBIDDEN`, ADR 182). Bir anahtarın eklediği kapalı bir webhook'u bir kişi açarsa webhook o kişinin olur.
+     * Kapalıyken olaylar gönderilmez; yeniden açılınca açıldığı andan sonraki olaylar gelir ve başarısızlık sayacı sıfırlanır. Bir API anahtarı yalnız olaylarını okuyabildiği bir webhook'u açabilir; yalnız kendi eklediği webhook'ları kapatabilir, başkasınınkini kapatmak için her yerde `passes.read` gerekir (`403 FORBIDDEN`). Bir anahtarın eklediği kapalı bir webhook'u bir kişi açarsa webhook o kişinin olur.
      *
      * **Kimlik:** ekip oturumu, API anahtarı.
      *
@@ -3304,7 +3330,7 @@ export class RewloyMethods {
      * 3. son zamanlarda sık gidilenler: son 90 günün ziyaretleri, yenisi daha ağır (her ziyaret bugün 1, 30 gün önce ½, 60 gün önce ¼ sayılır);
      * 4. en yeni kart;
      * bütün kartları bitmiş işletmeler en sonda. Bir işletmenin içinde önce etkin kartlar, en eskisi önce. Konuma göre sıralamak uygulamanın işidir: her kart işletmesinin şubelerini (`places`) taşır, konum sunucuya gönderilmez; yıldızlılar yine en başta kalsın.
-     * **Listeden kaldırılan kartlar** (`hidden: true`, ADR 159) bu sıranın ardından, en sonda gelir ve sırayı etkilemez: Kartlarım'ı ve işletme görünümünü onları atlayarak çizin; bütün kartları kaldırılmış işletme Kartlarım'da görünmez. Eski kartlar biten kartlardır (`ended: true`), kaldırılmış olsun olmasın: en son biten önce (`endedAt`, kaydı olmayan en sonda).
+     * **Listeden kaldırılan kartlar** (`hidden: true`) bu sıranın ardından, en sonda gelir ve sırayı etkilemez: Kartlarım'ı ve işletme görünümünü onları atlayarak çizin; bütün kartları kaldırılmış işletme Kartlarım'da görünmez. Eski kartlar biten kartlardır (`ended: true`), kaldırılmış olsun olmasın: en son biten önce (`endedAt`, kaydı olmayan en sonda).
      * `merchant` (kartlardaki `merchantSlug`) yalnız o işletmenin kartlarını işletme görünümünün sırasıyla verir, listeden kaldırılanlar sonda.
      *
      * **Kimlik:** kart sahibi oturumu.
@@ -3560,7 +3586,7 @@ export class RewloyMethods {
      *
      * Hesap, kasadaki QR'ın programına katılır. Kart, hesabın seçilen doğrulanmış adresi ya da numarasıyla verilir ve hesaba bağlanır. Adresle katılımda kartın bağlantısı o adrese de gider: telefon kaybolsa da kart kaybolmaz; numaraya hiçbir şey gitmez. Katılım, aydınlatma metninin sunulduğu andır; bu kayıt (`kvkkConsent: true`) kaynağıyla tutulur (kaynak: Rewloy Cüzdan uygulaması, `cuzdan-app`).
      * - `email` ya da `verifiedPhone` (yalnız biri): `GET /v1/holder/programs/{id}` yanıtındaki `emails` ya da `phones` içinden biri. Hesapta doğrulanmamış bir adres ya da numara `400 VALIDATION` döner, çünkü bir forma yazılan adres bir şey kanıtlamaz. Numarayla katılımda programın telefon sorusu sorulmaz: numara telefondur.
-     * - İşletmede hesabın başka bir adresi ya da numarasıyla açılmış bir kaydı varsa yeni kayıt açılmaz: seçilen adres ya da numara o kayda eklenir (ADR 165).
+     * - İşletmede hesabın başka bir adresi ya da numarasıyla açılmış bir kaydı varsa yeni kayıt açılmaz: seçilen adres ya da numara o kayda eklenir.
      * - Programın sorduğu öteki alanlar (`fields`) gövdede gelir; zorunlu biri eksikse `FIELD_REQUIRED`.
      * - Hesabın bu programda zaten kartı varsa yeni kart verilmez, o kart döner (`created: false`, `200`); katılım kapalıyken de. Aynı anda gelen iki istek de tek kart yapar. Yeni kart `201` ile döner.
      * - Kartı olmayan hesap için katılım kimliksiz katılımdaki gibi kapanır (`JOIN_CLOSED`). IP başına 10 dakikada 30 katılım sınırı da kimliksiz katılımla ortaktır.
@@ -3577,7 +3603,7 @@ export class RewloyMethods {
     /**
      * Kodu tek dokunuşla kullan
      *
-     * Hediye kartı, kupon ya da indirim kodu (`/c/{code}`) bu hesapla kullanılır: kart, hesabın seçilen doğrulanmış adresi ya da numarasıyla verilir ve hesaba bağlanır. Web'deki `/c/{code}` sayfasının oturum açıkken yaptığıdır (ADR 165). Kodun ne verdiği ve sorduğu alanlar `GET /v1/public/codes/{code}` ile öğrenilir.
+     * Hediye kartı, kupon ya da indirim kodu (`/c/{code}`) bu hesapla kullanılır: kart, hesabın seçilen doğrulanmış adresi ya da numarasıyla verilir ve hesaba bağlanır. Web'deki `/c/{code}` sayfasının oturum açıkken yaptığıdır. Kodun ne verdiği ve sorduğu alanlar `GET /v1/public/codes/{code}` ile öğrenilir.
      * - `email` ya da `verifiedPhone` (yalnız biri): hesabın doğrulanmış adreslerinden ya da numaralarından biri; hesapta doğrulanmamışsa `400 VALIDATION`. Numarayla alımda programın telefon sorusu sorulmaz: numara telefondur.
      * - Kişi başına sınır kişide sayılır, hangi adres ya da numarayla tanınırsa tanınsın. Sınır dolduysa yeni kart verilmez, kişinin bu koddan aldığı son kart döner (`created: false`, `200`).
      * - İşletmede hesabın başka bir adresi ya da numarasıyla açılmış bir kaydı varsa yeni kayıt açılmaz: seçilen adres ya da numara o kayda eklenir.
@@ -3763,7 +3789,7 @@ export class RewloyMethods {
     /**
      * E-postayı ya da numarayı değiştir: kod gönder
      *
-     * Hesabın bir e-postasının ya da numarasının (`GET /v1/holder/account` listesindeki kimliği) yerine yenisi (ADR 170): adrese `email`, numaraya `phone` (aynı türden). Yeniye 6 haneli bir kod gider; kodu bu yanıttaki `request` ile `POST /v1/holder/identities/{id}/replace/verify` gönderin.
+     * Hesabın bir e-postasının ya da numarasının (`GET /v1/holder/account` listesindeki kimliği) yerine yenisi: adrese `email`, numaraya `phone` (aynı türden). Yeniye 6 haneli bir kod gider; kodu bu yanıttaki `request` ile `POST /v1/holder/identities/{id}/replace/verify` gönderin.
      * - Uygulamanın oturumu cihazın kanıtıdır (web'deki cihaz anahtarının yerine).
      * - Yeni adres ya da numara eskisiyle aynıysa ya da zaten bu hesabınsa `409 IDENT_SAME`. Numara için telefonla giriş açık değilse `501 NOT_ENABLED`; `channel` ve sınırlar `POST /v1/holder/identities/phone` gibidir. Hesap başına saatte 10 (ekleme ve değiştirme birlikte).
      * - **Idempotency-Key** (isteğe bağlı, önerilir; 8–64 karakter, her yeni istek için yeni bir UUID): aynı anahtar ve aynı gövdeyle tekrar yeni kod GÖNDERMEZ, ilk yanıtı (aynı `request`) `Idempotent-Replayed: true` ile döndürür ve sınırlardan düşmez — bağlantısı kopan uygulama güvenle yineler. Aynı anahtar başka bir gövdeyle `422 IDEMPOTENCY_KEY_REUSED`; ilk istek sürerken `409 IDEMPOTENCY_IN_PROGRESS` (bir şey gönderilmez). Yanıt şifreli saklanır, 7 gün tekrar edilir; kodun kendisi 15 dakika geçerlidir, yeni kod için yeni anahtar gönderin. Oturumsuz çağrıda anahtar istemcinin IP adresine bağlıdır. Başlık yoksa her çağrı yeni bir kod ve yeni bir `request` demektir.
@@ -3780,8 +3806,8 @@ export class RewloyMethods {
     /**
      * E-postayı ya da numarayı değiştir: kodu doğrula
      *
-     * Değiştirme adımının `request` değeri ve yeniye gelen kod (ADR 170, PHONE.md §12.1).
-     * - Hesaba girmenin en az 72 saattir (`recovery.wait_hours`) hesapta olan başka bir yolu varsa (bir e-posta, bir numara, passkey, Google ya da Apple; yeni eklenen ya da bir birleştirmeyle gelen sayılmaz, ADR 172) yenisi eskisinin yerini hemen alır (`applied`): işletmelerdeki kayıtlar yeniye geçer, hesabın öteki adreslerine e-posta, öteki cihazlarına bildirim gider.
+     * Değiştirme adımının `request` değeri ve yeniye gelen kod.
+     * - Hesaba girmenin en az 72 saattir (`recovery.wait_hours`) hesapta olan başka bir yolu varsa (bir e-posta, bir numara, passkey, Google ya da Apple; yeni eklenen ya da bir birleştirmeyle gelen sayılmaz) yenisi eskisinin yerini hemen alır (`applied`): işletmelerdeki kayıtlar yeniye geçer, hesabın öteki adreslerine e-posta, öteki cihazlarına bildirim gider.
      * - Yoksa değişiklik bekler (`pending`, `change.dueAt`; ayar `recovery.wait_hours`, 72 saat): o zamana kadar eskisiyle girilir, yenisiyle girilmez. Eski adrese iptal bağlantılı bir e-posta, öteki cihazlara bildirim gider; SMS ya da WhatsApp gitmez.
      * - Yeni adres ya da numara başka bir Rewloy Cüzdan hesabındaysa `409 MERGE_REQUIRED` (`details.request`): kişiye sorun, yanıtı `POST /v1/holder/merge` ile gönderin; birleşince değişiklik yapılır. Eski giriş yolu, birleşmeden önce bu hesaba girmenin tek yoluysa değişiklik yine bekler (öteki hesabın giriş yolları sayılmaz).
      * - Yanlış kodda `CODE_INVALID`. Eski giriş yolu artık hesapta değilse `404 NOT_FOUND`.
@@ -3798,7 +3824,7 @@ export class RewloyMethods {
     /**
      * Bekleyen değişikliği iptal et ("Bu değişikliği ben yapmadım")
      *
-     * Hesabın bekleyen giriş yolu değişikliğini (`GET /v1/holder/account` `pendingChange.id`) ya da onaylanmış ve bekleyen bir kurtarma talebini (`pendingRecovery.id`) iptal eder (ADR 170).
+     * Hesabın bekleyen giriş yolu değişikliğini (`GET /v1/holder/account` `pendingChange.id`) ya da onaylanmış ve bekleyen bir kurtarma talebini (`pendingRecovery.id`) iptal eder.
      * - Değişikliği bu cihaz istediyse kişinin vazgeçmesidir. Başka bir cihaz iptal ederse "Bu değişikliği ben yapmadım" demektir: değişikliği isteyen cihazın oturumu kapanır ve hesap işaretlenir (kurtarma talepleri artık kendiliğinden onaylanmaz).
      * - Kurtarma talebi iptal edilirse hesap olduğu gibi kalır ve işaretlenir.
      * - Bekleyen bir şey yoksa (uygulandı, iptal edildi) `404 NOT_FOUND`.

package/dist/generated/operations.d.ts

@@ -1,7 +1,7 @@
 import type { OperationMeta } from '../types.js';
 import type { OperationId } from './types.js';
 /** The version of the API document this was generated from (`info.version`). */
-export declare const API_VERSION = "1.0.0";
+export declare const API_VERSION = "1.1.0";
 /** The metadata table: per operation, its method and path, the credential kinds it accepts, whether it takes `Rewloy-Merchant` and `Idempotency-Key`, how its answer is read and whether it is paged, streams or is deprecated. */
 export declare const OPERATIONS: {
     readonly [K in OperationId]: OperationMeta;

package/dist/generated/operations.js

@@ -1,7 +1,7 @@
 // Generated by scripts/generate.ts from the Rewloy OpenAPI document
-// (openapi/openapi.json, API 1.0.0). Do not edit: run `npm run generate`.
+// (openapi/openapi.json, API 1.1.0). Do not edit: run `npm run generate`.
 /** The version of the API document this was generated from (`info.version`). */
-export const API_VERSION = '1.0.0';
+export const API_VERSION = '1.1.0';
 /** The metadata table: per operation, its method and path, the credential kinds it accepts, whether it takes `Rewloy-Merchant` and `Idempotency-Key`, how its answer is read and whether it is paged, streams or is deprecated. */
 export const OPERATIONS = {
     issuePass: { method: 'POST', path: '/v1/passes', auth: ['key', 'staff'], merchant: true, idempotency: 'optional', body: true, response: 'json', paged: false, stream: false, deprecated: null },
@@ -10,6 +10,7 @@ export const OPERATIONS = {
     passAction: { method: 'POST', path: '/v1/passes/{serial}/actions', auth: ['key', 'staff'], merchant: true, idempotency: 'required', body: true, response: 'json', paged: false, stream: false, deprecated: null },
     recordSale: { method: 'POST', path: '/v1/passes/{serial}/sale', auth: ['key', 'staff'], merchant: true, idempotency: 'required', body: true, response: 'json', paged: false, stream: false, deprecated: null },
     reverseSale: { method: 'POST', path: '/v1/passes/{serial}/sale/reverse', auth: ['key', 'staff'], merchant: true, idempotency: null, body: true, response: 'json', paged: false, stream: false, deprecated: null },
+    reverseAction: { method: 'POST', path: '/v1/passes/{serial}/actions/reverse', auth: ['key', 'staff'], merchant: true, idempotency: null, body: true, response: 'json', paged: false, stream: false, deprecated: null },
     publicProgram: { method: 'GET', path: '/v1/public/programs/{id}', auth: ['public', 'holder', 'staff', 'key'], merchant: true, idempotency: null, body: false, response: 'json', paged: false, stream: false, deprecated: null },
     joinProgram: { method: 'POST', path: '/v1/public/programs/{id}/join', auth: ['public', 'holder', 'staff', 'key'], merchant: true, idempotency: null, body: true, response: 'json', paged: false, stream: false, deprecated: null },
     publicCode: { method: 'GET', path: '/v1/public/codes/{code}', auth: ['public', 'holder', 'staff', 'key'], merchant: true, idempotency: null, body: false, response: 'json', paged: false, stream: false, deprecated: null },
@@ -361,6 +362,9 @@ export const ERROR_TITLES = {
     SALE_NOT_FOUND: 'Geri alınacak satış yok',
     SALE_AMBIGUOUS: 'Bu notla birden çok satış var',
     SALE_ALREADY_SPENT: 'Satışın kazandırdığı kullanılmış',
+    ACTION_NOT_FOUND: 'Geri alınacak işlem yok',
+    ACTION_AMBIGUOUS: 'Bu notla birden çok işlem var',
+    ACTION_NOT_REVERSIBLE: 'İşlem geri alınamaz',
     WRONG_LOCATION: 'Kart bu şubede geçerli değil',
     INVALID_PROMOTION: 'Kasa kampanyası geçersiz',
     PROMOTION_NOT_FOUND: 'Kasa kampanyası bulunamadı',