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.