Prerequisites

Before you start integrating with the InvoisX API, make sure you have the following set up.

1. InvoisX Account

You need an InvoisX account with a registered company. If you don't have one:

1. Visit invoisx.com and sign up
2. Complete your company profile with business details
3. Configure your company's LHDN credentials

2. LHDN Credentials

Your company must be registered with LHDN's MyInvois system. You'll need:

Credential	Description
TIN (Tax Identification Number)	Your company's tax ID from LHDN
Client ID	OAuth client ID from LHDN portal
Client Secret	OAuth client secret from LHDN portal

Testing Environment

For testing, you can use LHDN's preprod (sandbox) credentials. These are separate from your production credentials and allow you to test without affecting real invoices.

Setting Up LHDN Credentials

1. Log in to your InvoisX dashboard
2. Navigate to Company Settings > LHDN Integration
3. Enter your LHDN credentials
4. Choose environment: Preprod (testing) or Production
5. Click Save & Verify

3. Active Subscription

An active InvoisX subscription is required to submit documents to LHDN. Check your subscription status in Settings > Billing.

4. Development Environment

You'll need a way to make HTTP requests. Here are some options:

cURL

# Test your connection
curl -X GET https://invoisx.com/api/v1/states \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Node.js

// Using fetch (Node.js 18+)
const response = await fetch('https://invoisx.com/api/v1/states', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Accept': 'application/json'
  }
});

Python

import requests

response = requests.get(
    'https://invoisx.com/api/v1/states',
    headers={
        'Authorization': 'Bearer YOUR_API_TOKEN',
        'Accept': 'application/json'
    }
)

PHP

$response = Http::withToken('YOUR_API_TOKEN')
    ->accept('application/json')
    ->get('https://invoisx.com/api/v1/states');

Checklist

Before proceeding, ensure you have:

• [ ] InvoisX account created
• [ ] Company profile completed
• [ ] LHDN credentials configured (preprod for testing)
• [ ] Active subscription
• [ ] API token ready (create one here)

Next Steps

Once you have everything ready, proceed to Authentication to create your API token.