Reload Setup Menu

Page Purpose

The Reload Setup page is used to set up MAXsi Reload / TopUp inside MAXsi POS, so you can:

  1. Register your device (phone) for Reload services.
  2. Validate agent credentials (WhatsApp, Agent ID, PIN).
  3. Generate and share a WhatsApp verification message.
  4. Download the digital product catalog.
  5. Import the catalog into your store database.
  6. Reset (delete) reload products when needed.

Typically you do this once during onboarding, then revisit it if you change agent credentials, move devices, reinstall the app, or want to refresh the catalog.

“Agent Validation” Section

This section is where you enter the credentials used for Reload.

1) Registered WhatsApp Number

Enter the WhatsApp number that is registered in MAXsi Reload.

  • Example format: 62812xxxxxx
  • If the format is wrong or incomplete, validation can fail.

2) Agent ID

Enter your Agent ID (example shown in the app: AGN001).

  • Agent ID is required.

3) Reload PIN

Enter the PIN used for Reload transactions.

  • PIN is required.
  • This field is masked for privacy.

Simpan (Save) Button

Function:

  • Saves WhatsApp number + Agent ID + PIN locally in the app (used during Reload transactions).

Use this if you want to save credentials first without validating yet.

Validasi (Validate) Button

Function:

  • Connects to the MAXsi Reload server to validate your agent credentials and device.
  • On success, the button changes to “Validated ✓” (label may vary by app language).

Important notes:

  • After validation, there is a short time window (timer) to complete WhatsApp verification.
  • If the timer expires, tap Validate again.

Verification Message (Text Box)

After a successful validation, the app shows a verification message containing:

  • Agent ID
  • Device ID (App Instance ID)
  • Device name (e.g., MAXsi POS-android / MAXsi POS-ios)

This message is meant to be sent via WhatsApp as instructed by the Reload service.

“Share to WhatsApp” Button

Function:

  • Opens the share menu and sends the verification message to WhatsApp.

This button works only if:

  • You already validated, and
  • The validation timer is still active.

“Reset ID” Button

Function:

  • Regenerates the unique app/device ID used for Reload.

Common use cases:

  • You changed phones / reinstalled the app.
  • You want to restart activation from scratch.
  • WhatsApp verification is stuck.

Note:

  • Resetting the ID disables the active Reload state, so you must validate again.

“Digital Product Catalog” Section

This section is used to fetch and import the digital product catalog into your store database.

“Download” Button

Function:

  • Downloads the digital catalog from the Reload server.
  • Saves it to your device as products_reload.json.

Requirements:

  • You must have validated and be in a Verified state.

On success, you’ll see the saved file path.

“Import” Button

Function:

  • Reads the downloaded catalog file.
  • Imports the digital products into your store database.

While importing, the app may show progress (e.g., “Import batch 1/…”). When done, you’ll see a summary:

  • Total
  • Inserted (new)
  • Updated
  • Skipped

Requirements:

  • The catalog file must exist (download first).
  • Validation and Verified state must be active.

“Reset Reload Products” Button

Function:

  • Deletes all reload products from your store database.

Important:

  • This targets products of type semi digital (reload products).
  • Use with care (for example, before a clean re-import).

Import Options (Switches)

Below the buttons, you may see switches such as:

  1. Update selling price

    • ON: import updates selling prices from the catalog (when available).
    • OFF: existing selling prices may be preserved (depending on import rules).

  2. Set hide = 1

    • ON: imported products are marked “hidden” for operational needs.

  3. Set hide_pos = 1

    • ON: imported products are hidden from the POS screen.
  1. Enter Registered WhatsApp, Agent ID, and Reload PIN.
  2. Tap Save (Simpan) (optional but recommended).
  3. Tap Validate (Validasi) until you see “Validated ✓”.
  4. Tap Share to WhatsApp and send the verification message.
  5. After you become Verified, tap Download.
  6. After download succeeds, tap Import.

Troubleshooting

  1. “Validation failed”

    • Confirm WhatsApp is correct and registered.
    • Confirm Agent ID and PIN are correct.
    • Retry Validate.

  2. “Validation token expired”

    • Validate again, then share to WhatsApp while the timer is active.

  3. “Catalog file not found”

    • Download the catalog first.

  4. “WebSocket connection failed” / download failed

    • Check your internet connection.
    • Retry download.

Practical Tips

  • Validate on a stable connection because the verification window is time-limited.
  • When changing phones, use “Reset ID” then validate again.
  • If the catalog is outdated, reset reload products and re-import.

Note: This guide content may still be in Indonesian while we prepare the English version.

Published by: MAXsi POS — Android POS App