From 8fc779e55a65d37280774d9668b6a62499337cc1 Mon Sep 17 00:00:00 2001
From: "ravproject.dev" <ravialdo.dev@gmail.com>
Date: Tue, 24 Feb 2026 16:52:51 +0700
Subject: [PATCH] docs: Add PROJECT_ID field and explain the order ID suffix
 mechanism for Midtrans integration.

---
 INTEGRASI_TEKNIS.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/INTEGRASI_TEKNIS.md b/INTEGRASI_TEKNIS.md
index 9da9825..69fb6ea 100644
--- a/INTEGRASI_TEKNIS.md
+++ b/INTEGRASI_TEKNIS.md
@@ -28,8 +28,17 @@ Penting bagi developer client untuk memahami dua jenis ID yang digunakan:
 
 | ID Field | Tipe | Sumber | Kegunaan |
 | :--- | :--- | :--- | :--- |
-| **`order_id`** | UUID | Database Gateway | Internal Primary Key (digunakan untuk query join). |
-| **`external_id`** | String | Sistem Client | ID Invoice/Referens (misal: `INV-100`). Dikirim ke Midtrans. |
+| **`order_id`** | UUID | Database Gateway | Internal Primary Key (UUID). |
+| **`external_id`** | String | Sistem Client | ID Invoice/Referens (misal: `INV-100`). |
+| **`PROJECT_ID`** | String | Env Gateway | Suffix unik (misal: `proj_1768277934546`). |
+
+### Mekanisme Suffix Order ID
+Gateway ini secara otomatis menggabungkan `external_id` dan `PROJECT_ID` saat mengirim data ke Midtrans.
+*   **Contoh:** Jika `external_id` adalah `INV-1001` dan `PROJECT_ID` adalah `proj_123`, maka ID yang terdaftar di Midtrans adalah `INV-1001-proj_123`.
+
+> [!TIP]
+> **Mengapa menggunakan Suffix?**
+> Suffix ini sangat krusial bagi **Midtrans Router Hub**. Ketika Router menerima notifikasi dari Midtrans, ia akan membaca bagian akhir dari `order_id` untuk menentukan ke gateway mana notifikasi tersebut harus diteruskan.
 
 > [!IMPORTANT]
 > Saat memanggil API Gateway, kedua ID ini wajib disertakan dalam payload untuk menjaga integritas data lintas sistem.