ravialdo/midtrans-gateway
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Add PROJECT_ID field and explain the order ID suffix mechanism for Midtrans integration.

Browse Source
This commit is contained in:
ravproject.dev
2026-02-24 16:52:51 +07:00
parent 623daa19b9
commit 8fc779e55a
1 changed files with 11 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
INTEGRASI_TEKNIS.md
View File

@@ -28,8 +28,17 @@ Penting bagi developer client untuk memahami dua jenis ID yang digunakan:
| ID Field | Tipe | Sumber | Kegunaan | | ID Field | Tipe | Sumber | Kegunaan |
| :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- |
| **`order_id`** | UUID | Database Gateway | Internal Primary Key (digunakan untuk query join). | | **`order_id`** | UUID | Database Gateway | Internal Primary Key (UUID). |
| **`external_id`** | String | Sistem Client | ID Invoice/Referens (misal: `INV-100`). Dikirim ke Midtrans. | | **`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] > [!IMPORTANT]
> Saat memanggil API Gateway, kedua ID ini wajib disertakan dalam payload untuk menjaga integritas data lintas sistem. > Saat memanggil API Gateway, kedua ID ini wajib disertakan dalam payload untuk menjaga integritas data lintas sistem.