feat(loyalty): remove paying with EnakPoint

EnakPoint can only be redeemed for vouchers now: it can no longer pay for orders and is never cashed out (docs/enakgame-prd.md §3.2, EG-001, EG-002). No order was ever paid with EnakPoint, so there is no data to move. Removed: - POST /customer/wallet/payment-code, POST /customer/orders/:id/pay-with-points and GET /orders/:id/point-payment/preview, with their processors, repositories, services, handlers and tests. - The point payment method type: paying, splitting and refunding with it, the outlet filter on the method list, and the system-method guard. - points and payment_code on CreatePayment; points_used and point_value on payments; accepts_point_payment on the customer outlets. - The outlet point_payment settings. A PUT that still sends them is rejected as an unknown field. - The EnakPoint split in the payment method analytics. - PAYMENT and PAYMENT_REFUND from the wallet type rules. Tests that used them as a generic EnakPoint debit use REWARD_REDEEM. - The EnakPoint-paid part from the earning basis, which is subtotal − discount again. Migration 000102 drops the trigger, the point methods and their index, the payments columns, and the outlet settings, and restores the method type CHECK without point. payments.payment_method_id is ON DELETE RESTRICT, so it fails rather than lose a payment made with EnakPoint. The integration docs list the removed endpoints and fields, and the EnakPoint & EnakCoin PRD and tasks note what is superseded. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 13:48:29 +07:00
parent 3ebc09f818
commit 2c9753fae7
87 changed files with 423 additions and 3071 deletions
@@ -6,6 +6,12 @@ lama tetap jalan sebagai alias (lihat §8)
 Panduan untuk memakai saldo loyalitas dari sisi klien. Alasan di balik setiap aturan
 ada di [`prd-point-coin.md`](./prd-point-coin.md).

+> **Perubahan 7 Okt 2026:** bayar order dengan EnakPoint sudah dihapus (migrasi
+> `000102`). EnakPoint sekarang hanya bisa ditukar ke voucher, tidak bisa dipakai
+> sebagai alat bayar dan tidak bisa dicairkan
+> ([`enakgame-prd.md`](./enakgame-prd.md) §3.2). Endpoint dan field yang ikut dihapus
+> ada di §8.
+
 ---

 ## 1. Konsep inti
@@ -13,21 +19,21 @@ ada di [`prd-point-coin.md`](./prd-point-coin.md).
 | | EnakPoint (`POINT`) | EnakCoin (`COIN`) |
 |---|---|---|
 | Didapat dari | Order lunas (per outlet), adjustment admin, exchange | Order lunas (per outlet), adjustment admin |
-| Dipakai untuk | **Membayar order** | **Main game**, ditukar ke EnakPoint |
+| Dipakai untuk | **Ditukar ke voucher** (tidak bisa membayar order) | **Main game**, ditukar ke EnakPoint |
 | Bisa ditransfer | Ya | Ya |
 | Bisa kedaluwarsa | Ya, bila diaktifkan owner | Ya, bila diaktifkan owner |

 Aturan yang berlaku di seluruh dokumen ini:

 1. **Semua jumlah bilangan bulat.** Tidak ada "setengah EnakPoint".
-2. **Saldo tidak pernah jadi uang.** Tidak ada pencairan, tidak ada kembalian, dan
-   bagian order yang dibayar EnakPoint hanya bisa kembali sebagai EnakPoint. Tampilkan
-   nilai rupiahnya sebagai **"setara potongan Rp …"**, bukan "saldo Rp …".
-3. **Semua aksi customer yang memindahkan saldo butuh PIN 6 digit** (§3): bayar,
-   buat kode bayar, exchange, transfer. Main game tidak butuh PIN.
+2. **Saldo tidak pernah jadi uang.** Tidak ada pencairan, dan EnakPoint tidak bisa
+   dipakai membayar order. Tampilkan nilai rupiahnya sebagai **"setara potongan
+   Rp …"**, bukan "saldo Rp …".
+3. **Semua aksi customer yang memindahkan saldo butuh PIN 6 digit** (§3): exchange
+   dan transfer. Main game tidak butuh PIN.
 4. **Wallet milik customer di satu organisasi.** Saldo berlaku di semua outlet
   organisasi itu. Nilai rupiah EnakPoint, kurs exchange, batas transfer, dan
-   kedaluwarsa diatur per organisasi; earning dan penerimaan pembayaran per outlet.
+   kedaluwarsa diatur per organisasi; earning per outlet.
 5. **Setiap mutasi tercatat** di riwayat beserta asal atau tujuannya, dan tidak pernah
   dihapus. Koreksi muncul sebagai baris baru.

@@ -91,7 +97,7 @@ Semua endpoint customer memakai header `Authorization: Bearer <token customer>`.

 ### 2.2 Riwayat

-`GET /api/v1/customer/wallet/transactions?page=1&limit=20&currency=POINT&type=EARN,PAYMENT&from=2026-09-01&to=2026-09-30`
+`GET /api/v1/customer/wallet/transactions?page=1&limit=20&currency=POINT&type=EARN,TRANSFER_IN&from=2026-09-01&to=2026-09-30`

 Semua query opsional. `limit` 1–100 (default 20). `type` boleh beberapa, dipisah koma.
 `from` / `to` tanggal WIB, inklusif.
@@ -119,8 +125,8 @@ Semua query opsional. `limit` 1–100 (default 20). `type` boleh beberapa, dipis

 - `amount` bertanda: positif menambah saldo, negatif mengurangi.
 - Penambahan punya `source`, pengurangan punya `destination`. Keduanya berbentuk
-  `{ type, id }` dan menunjuk hal yang bisa dibuka di detail (order, pembayaran, game
-  play, dst.).
+  `{ type, id }` dan menunjuk hal yang bisa dibuka di detail (order, game play,
+  dst.).
 - `description` sudah siap tampil dan tidak berubah walau nama outlet atau customer
  berubah belakangan. Nama lawan transfer sudah disamarkan.
 - Dua baris exchange atau transfer berbagi `group_id` yang sama.
@@ -129,8 +135,6 @@ Semua query opsional. `limit` 1–100 (default 20). `type` boleh beberapa, dipis
 |---|---|---|---|
 | `EARN` | + | Didapat dari order lunas | `ORDER` |
 | `EARN_REVERSAL` | − | Ditarik karena order di-void/refund | `ORDER` |
-| `PAYMENT` | − | Membayar order | `PAYMENT` |
-| `PAYMENT_REFUND` | + | Kembali karena pembayaran di-void/refund | `PAYMENT` |
 | `EXCHANGE_OUT` / `EXCHANGE_IN` | − / + | Tukar EnakCoin ke EnakPoint | `WALLET_TX` (baris pasangannya) |
 | `TRANSFER_OUT` / `TRANSFER_IN` | − / + | Transfer antar customer | `WALLET_TX` (baris pasangannya) |
 | `GAME_SPEND` | − | Main game | `GAME_PLAY` |
@@ -219,7 +223,7 @@ menghasilkan `429`.
 - **Lupa PIN:** minta OTP dengan `purpose: "pin_reset"`, lalu
  `POST /api/v1/customer/pin/reset` dengan body yang sama seperti §3.2. Reset juga
  membuka PIN yang terkunci. Setelah reset, **transfer keluar ditahan 24 jam**;
-  pembayaran dan exchange tetap bisa.
+  exchange tetap bisa.

 ### 3.4 Menangani error PIN

@@ -247,123 +251,19 @@ reinstall atau ganti HP.

 ---

-## 4. Membayar dengan EnakPoint
+## 4. Earning, void, dan refund

-Ada dua jalur. Keduanya memakai logika perhitungan yang sama.
-
-### 4.1 Batas pembayaran
-
-EnakPoint maksimal yang bisa dipakai untuk satu order:
-
-```
-batas_rupiah = min(sisa_tagihan, total_order × max_payment_percent / 100 − yang_sudah_dibayar_EnakPoint)
-maks_point   = min(saldo_customer, floor(batas_rupiah / point_value))
-```
-
-Ditambah minimal `min_payment_points` per pembayaran. Nominal rupiah pembayaran selalu
-`points × point_value` dan **tidak pernah melebihi sisa tagihan**, jadi tidak ada
-kembalian. Sisa tagihan dibayar dengan method lain seperti biasa (split).
-
-### 4.2 POS — kode bayar dari aplikasi customer
-
-PIN **tidak pernah** diketik di perangkat kasir. Customer menyetujui di HP-nya sendiri:
-
-1. **Customer app:** `POST /api/v1/customer/wallet/payment-code` dengan `{ "pin": "482913" }`.
-
-   ```json
-   { "code": "482913", "qr_payload": "enakpoint:482913", "expires_at": "2026-09-30T05:02:00Z" }
-   ```
-
-   Tampilkan `code` sebagai angka dan `qr_payload` sebagai QR. Kode berlaku **2 menit**,
-   sekali pakai, dan hanya untuk customer itu. Membuat kode baru membatalkan kode lama.
-
-2. **POS:** tampilkan batas untuk tombol "pakai maksimal":
-
-   `GET /api/v1/orders/:id/point-payment/preview`
-
-   ```json
-   {
-     "order_id": "…",
-     "customer_id": "…",
-     "eligible": true,
-     "point_balance": 12500,
-     "point_value": 1,
-     "remaining_amount": 87500,
-     "min_payment_points": 1,
-     "max_payment_percent": 100,
-     "max_points": 12500,
-     "max_amount": 12500
-   }
-   ```
-
-   Bila `eligible: false`, `reason` menjelaskan kenapa (order walk-in, outlet tidak
-   menerima EnakPoint, saldo di bawah minimal, dst.).
-
-3. **POS:** bayar lewat endpoint pembayaran yang sudah ada, dengan payment method
-   bertipe `point`:
-
-   `POST /api/v1/payments` (header `X-Idempotency-Key` wajib seperti pembayaran lain)
-
-   ```json
-   {
-     "order_id": "…",
-     "payment_method_id": "<id method EnakPoint>",
-     "points": 12500,
-     "payment_code": "482913"
-   }
-   ```
-
-   `amount` tidak perlu dikirim; backend menghitungnya. `payment_code` boleh berupa
-   angka yang diketik kasir atau hasil scan QR apa adanya (`enakpoint:482913`).
-
-Response pembayaran membawa `points_used` dan `point_value` untuk struk, misalnya
-"EnakPoint: 12.500 (Rp 12.500)". Jika pembayaran ini melunasi order, order menjadi
-`completed`; jika belum, sisanya dibayar dengan method lain.
-
-Pembayaran ditolak (`304`, `cause` menjelaskan) bila: order tanpa customer atau
-customer walk-in, customer nonaktif, outlet tidak menerima EnakPoint, `points` di luar
-batas §4.1, kode salah/kedaluwarsa/sudah dipakai/milik customer lain, atau method
-EnakPoint dipakai sebagai split (bayar bagian EnakPoint sebagai pembayaran tersendiri,
-lalu split sisanya seperti biasa). Kode bayar dipakai habis begitu diterima, sebelum
-batas dicek ulang; bila pembayaran lalu ditolak (misalnya saldo berubah), minta
-customer membuat kode baru.
-
-**Method EnakPoint** dibuat otomatis untuk setiap organisasi dan tidak bisa dihapus
-atau diubah tipenya (namanya boleh diganti). Daftar payment method yang dikirim
-`?outlet_id=` tidak menampilkannya bila outlet itu tidak menerima EnakPoint.
-
-### 4.3 Customer app / self-order — bayar order sendiri
-
-`POST /api/v1/customer/orders/:id/pay-with-points`
-
-```json
-{ "points": 12500, "pin": "482913" }
-```
-
-Hanya untuk order milik customer yang login; order lain dijawab `404`. Response sama
-dengan response pembayaran di §4.2.
-
-### 4.4 Void dan refund
-
- **Void order:** semua EnakPoint yang dipakai kembali ke customer sebagai EnakPoint.
- **Refund pembayaran EnakPoint** (`POST /api/v1/payments/:id/refund` pada pembayaran
-  EnakPoint): yang kembali `floor(rupiah_direfund / point_value_saat_bayar)`. Perubahan
-  nilai EnakPoint setelah pembayaran tidak mengubah jumlah yang kembali; sisa di bawah
-  1 EnakPoint hangus.
- **Refund order ke tunai / method lain** hanya boleh sebesar bagian yang dibayar
-  dengan method lain. Bagian EnakPoint harus direfund lewat pembayaran EnakPoint-nya
-  sendiri; mencoba lewat tunai dijawab `304`.
- EnakPoint yang kembali mengikuti tanggal kedaluwarsa asalnya, tapi minimal 7 hari
-  sejak refund.
- EnakPoint dan EnakCoin yang didapat dari order ikut ditarik saat void/refund. Bila
-  saldo customer sudah terpakai, yang ditarik sebanyak yang ada; refund tidak pernah
-  diblokir karena ini.
-
-### 4.5 Earning di layar order dan struk
+EnakPoint bukan payment method: tidak ada payment method bertipe `point`, dan
+`POST /api/v1/payments` memakai `amount` seperti pembayaran lain. Kode bayar,
+bayar dari aplikasi, dan preview pembayaran EnakPoint sudah dihapus (§8).

 Response order membawa `points_earned` dan `coins_earned` (0 bila order tidak
-menghasilkan apa-apa). Earning dihitung dari `subtotal − discount − bagian yang
-dibayar EnakPoint`, sebelum pajak, dan diberikan saat order lunas.
+menghasilkan apa-apa). Earning dihitung dari `subtotal − discount`, sebelum pajak, dan
+diberikan saat order lunas.
+
+EnakPoint dan EnakCoin yang didapat dari order ikut ditarik saat void/refund. Bila
+saldo customer sudah terpakai, yang ditarik sebanyak yang ada; refund tidak pernah
+diblokir karena ini.

 ---

@@ -504,6 +404,24 @@ Semua yang bernama token sudah dihapus: `GET /customer/tokens`, `total_tokens`,
 `tokens_history`, `token_used`, `tokens_remaining`, dan nilai `TOKENS` di campaign. Pakai
 `coin_balance`, `coins_used`, `coins_remaining`, dan `COINS`.

+Bayar dengan EnakPoint juga sudah dihapus (7 Okt 2026, migrasi `000102`) karena
+EnakPoint sekarang hanya untuk voucher ([`enakgame-prd.md`](./enakgame-prd.md) §3.2).
+Tidak ada penggantinya:
+
+- Endpoint `POST /customer/wallet/payment-code`, `POST /customer/orders/:id/pay-with-points`,
+  dan `GET /orders/:id/point-payment/preview`.
+- Payment method tipe `point`, serta field `points` dan `payment_code` di
+  `POST /payments`; `amount` kembali wajib seperti pembayaran lain.
+- `points_used` dan `point_value` di response pembayaran dan di `payments` pada
+  `GET /customer/orders/:id`; `accepts_point_payment` di `GET /customer/outlets`.
+- Objek `point_payment` (`accept_payment`, `min_payment_points`,
+  `max_payment_percent`) di setting outlet (§9.1).
+- Di analytics payment method: `point_amount`, `points_used`, `total_with_points` di
+  `summary`, serta `points_used` dan `counts_as_cash_in` per baris.
+  `summary.total_amount` kembali total semua method, dan persentase dihitung dari total
+  itu.
+- Tipe mutasi `PAYMENT` dan `PAYMENT_REFUND` tidak ditulis lagi.
+
 ---

 ## 9. Dashboard
@@ -517,12 +435,12 @@ Semua endpoint di bagian ini butuh login user dengan role Admin atau Manager.
 ```json
 {
  "point": { "enabled": true, "earn_mode": "PER_AMOUNT", "earn_per_amount": 100, "earn_value": 1, "earn_percent": 1, "min_order_amount": 0, "max_per_order": null },
-  "coin": { "enabled": true, "earn_mode": "PER_AMOUNT", "earn_per_amount": 25000, "earn_value": 1, "earn_percent": 1, "min_order_amount": 0, "max_per_order": null },
-  "point_payment": { "accept_payment": true, "min_payment_points": 1, "max_payment_percent": 100 }
+  "coin": { "enabled": true, "earn_mode": "PER_AMOUNT", "earn_per_amount": 25000, "earn_value": 1, "earn_percent": 1, "min_order_amount": 0, "max_per_order": null }
 }
 ```

-Field yang tidak dikirim di `PUT` tetap memakai nilai sekarang. Response menambahkan
+Field yang tidak dikirim di `PUT` tetap memakai nilai sekarang. `PUT` yang masih
+mengirim `point_payment` ditolak `310` (field tidak dikenal). Response menambahkan
 `point_value` organisasi dan `point_cashback_percent`
 (`earn_value × point_value / earn_per_amount × 100`, atau `earn_percent × point_value`
 pada `earn_mode` `PERCENTAGE`). **Tampilkan persentase ini di
@@ -597,10 +515,10 @@ Riwayat perubahan: `GET /api/v1/marketing/loyalty-settings/history?page=1&limit=
  Adjustment tidak disertai pembayaran uang, jadi jangan pakai alasan "pencairan".

 - `GET /api/v1/marketing/wallet-transactions/:id/trace` — telusuri satu mutasi per
-  butir: lot mana yang dipakai atau dibuat, lalu rantai asalnya lewat transfer,
-  exchange, atau refund sampai ke earning/adjustment/migrasi pertama. Contoh: dari
-  pembayaran B bisa terlihat bahwa EnakPoint-nya berasal dari order #ORD-1 milik A
-  yang mentransfer ke B.
+  butir: lot mana yang dipakai atau dibuat, lalu rantai asalnya lewat transfer atau
+  exchange sampai ke earning/adjustment/migrasi pertama. Contoh: dari transfer keluar
+  B bisa terlihat bahwa EnakPoint-nya berasal dari order #ORD-1 milik A yang
+  mentransfer ke B.

 ### 9.4 PIN customer

@@ -624,10 +542,8 @@ Riwayat perubahan: `GET /api/v1/marketing/loyalty-settings/history?page=1&limit=
 - [ ] Baca `coins_used` / `coins_remaining` dan `/customer/wallet`, bukan field lama.

 **POS**
- [ ] Scan QR atau ketik kode bayar, jangan pernah meminta PIN customer di layar kasir.
- [ ] Pakai `point-payment/preview` untuk tombol "pakai maksimal".
- [ ] Cetak `points_used`, `points_earned`, dan `coins_earned` di struk.
- [ ] Refund bagian EnakPoint lewat pembayaran EnakPoint-nya, bukan tunai.
+- [ ] Cetak `points_earned` dan `coins_earned` di struk.
+- [ ] Jangan menampilkan EnakPoint sebagai payment method (§4).

 **Dashboard**
 - [ ] Tampilkan `point_cashback_percent`, `impact`, `expiry_preview`, dan