Merchant LHDN Configuration

Maintain merchant LHDN information

  1. Open the merchant account.
  2. Select Edit LHDN Info.
  3. Review or update the merchant's name, TIN, BRN, SST number, tourism tax number, address, contact information, country, state, and MSIC category as required.
  4. Review Submission On (Hourly) and Consolidated On (Monthly). Change them only when the merchant's approved submission schedule has changed.
  5. Select TIN Validation to check the tax information without saving, or TIN Validation & Save to validate and save it.

If validation fails, review the identifiers and merchant details before trying again. Do not bypass a validation failure by entering unverified information.

Configure the LHDN environment

  1. Open the merchant account.
  2. Select LHDN Configuration.
  3. Confirm whether Allow Submission On behalf Of applies to the merchant.
  4. Select the required LHDN Environment.
  5. Enter or update the merchant CID and client-secret values only when authorized.
  6. Review the LHDN API and identity-service addresses shown for the selected environment.
  7. Set Acting On Behalf Of when the approved submission arrangement requires it.
  8. Select Apply Changes.

Do not copy credentials from one merchant to another. Environment, credential, and acting-on-behalf settings must belong to the merchant being maintained.

Environment credentials are confidential. Do not place them in documentation, screenshots, email, or support tickets.