When using a dedicated external server, vendors need to link API endpoints to specific sub-items within their Kiosk listing. Below is the step-by-step workflow.

📍 STEP 1: OPEN INVENTORY MANAGEMENT

1. Log in to your vendor dashboard: partner.bm88.io/partner-kiosk

2. In the Manager Kiosks table, locate your API-enabled listing (indicated by a green checkmark 🟢 in the Api private column).

3. In the Action column, click the Folder icon 📂 (Inventory / Sub-items).

📍 STEP 2: SELECT ITEM VARIANT & OPEN API SETTINGS

1. The Items & Inventory Management modal window will appear.

2. Locate your target product variant, navigate to the Action column, and click the Plus icon ➕ (Update API Link).

📍 STEP 3: CONFIGURE ENDPOINTS & TEST CONNECTION

On the Update api link page, input your server's two API endpoints:

1. API get in stock:

   • Example URL: [https://api.your-domain.com/user/account_type?apikey=YOUR_KEY](https://api.your-domain.com/user/account_type?apikey=YOUR_KEY)

   • Expected Return Format (JSON): {"sum":10}

   • Click the green Test button to confirm accurate live stock counts.

2. Ordering API:

   • Example URL: [https://api.your-domain.com/user/buy?apikey=YOUR_KEY&order_id=](https://api.your-domain.com/user/buy?apikey=YOUR_KEY&order_id=){order_id}&quantity={so_luong}

   • Expected Return Format (JSON): [{"product":"credential_1"},{"product":"credential_2"}]

   • Click Test - Get 2 product to simulate fetching 2 test items.

📍 STEP 4: SAVE & ACTIVATE

1. Click the blue Save button to apply the API settings.

2. Delivered API order credentials and sales statuses (Sold) will be tracked in the historical log table below.