# Turn KWSP i-Akaun (Majikan) into an API

> Read contribution records, contribution payments and late payment charges from KWSP i-Akaun (Majikan, employer) with one API call each. A workflow can check before the 15th that the contribution month is paid, and email you if it is not.

Page: https://fous.com/automate/kwsp-i-akaun-majikan
Updated: 2026-11-12

Works with your own KWSP i-Akaun (Majikan) account. Fous is an independent product.

## What you can build on the employer i-Akaun

### Get contribution records

Reads the contribution details the employer i-Akaun keeps for one contribution month: each employee with the employer and employee shares.

- Takes: Contribution month
- Returns: Contribution month, employee name, member number, employer share, employee share, total

### Get contribution payments

Reads the payment history in the contribution records: which contribution months were paid, how and when, with the payment reference.

- Takes: Contribution month from, contribution month to (optional)
- Returns: Contribution month, amount paid, payment method, payment date, reference number, status

### Check late payment charges and instalments

Reads the late payment charges, approved instalment plans and assessments by EPF officers shown for your employer account.

- Takes: Nothing
- Returns: Contribution month, charge or assessment, amount, instalment plan, status

### Submit Form A from your payroll file

Opens Submit Contributions, picks the contribution month, uploads your TXT or CSV file, confirms the employee list and stops at the payment method.

- Takes: Contribution month, Form A file (TXT or CSV)
- Returns: Contribution month, employees, employer share total, employee share total, total

## Automate the employer i-Akaun with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Unpaid contribution month, checked before the 15th

Starts: Every month on the 13th at 9:00, Kuala Lumpur time

1. Get contribution payments for this contribution month and the one before.
2. Stop when a payment for that month is there.
3. Email you that the month is not yet paid, with last month's amount for reference.

### New late payment charges, posted to finance

Starts: Every Monday at 8:00, Kuala Lumpur time

1. Check late payment charges, instalments and assessments on the employer i-Akaun.
2. Keep the items that were not there on the last run.
3. Post each one, with contribution month, type and amount, to your finance team's webhook.

### Monthly contribution records, handed to accounting

Starts: Every month on the 20th at 10:00, Kuala Lumpur time

1. Get contribution records for the current contribution month.
2. Keep each employee's name, member number and shares, with the month's totals.
3. Post the per-employee rows and the totals to your accounting system's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get contribution records” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "secure.kwsp.gov.my/get_contribution_records",
    "input": {
      "contribution_month": "2026-11"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "employer": "Northwind Trading Sdn Bhd",
    "contribution_month": "2026-11",
    "employees": [
      {
        "name": "Employee One",
        "member_number": "00000001",
        "employer_share": 546,
        "employee_share": 462,
        "total": 1008
      }
    ],
    "employer_share_total": 1326,
    "employee_share_total": 1177,
    "total": 2503,
    "currency": "MYR",
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The employer i-Akaun’s own options

Payroll software does not connect to the employer i-Akaun through an API. Payroll providers produce Form A as a TXT or CSV file, which you upload under Submit Contributions for one contribution month, then pay through one of the methods the portal lists. Contribution records and payment history are viewed in the portal, and statements and receipts downloaded there.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Upload file (TXT/CSV) | Form A contribution details for one contribution month, uploaded under Contribution Payment, Submit Contributions. | A TXT or CSV file in KWSP's format, usually generated by your payroll software. |
| Payment methods after Form A | Pay through the bank's website, FPX, direct debit or Electronic Fund Transfer. | Bank website for Maybank customers only, direct debit only with a registered DDA, Electronic Fund Transfer only for government employers. |
| The employer i-Akaun by hand | Form A, payments, employee registration, contribution records, late payment charges, statements and receipts, one screen at a time. | An i-Akaun (Employer) account, applied for with Form KWSP 1(i) at a KWSP office and activated within 30 days. |

Read on November 12, 2026: [i-Akaun (Employer) sign-in](https://secure.kwsp.gov.my/employer/employer/login), [Submitting the EPF file through i-Akaun (PayrollPanda)](https://www.payrollpanda.my/help/how-to-submit-the-epf-csv-file-through-i-akaun/), [Generate and submit the EPF file (HReasily)](https://support.hreasilygroup.com/en/support/solutions/articles/72000566183-how-to-generate-and-submit-epf-file-).

## Signing in to the employer i-Akaun

The employer i-Akaun asks for your User ID, usually your EPF employer number, then shows your Secret Phrase before you enter your password. A forgotten password is reset with a TAC sent by SMS to a mobile number registered with KWSP. With Fous you sign in once through the i-Akaun's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **The contribution month runs one month ahead**: The contribution month is one month after the salary month: August salaries are the September contribution. A method that reads or submits Form A takes the contribution month, not the payroll month.
- **An uploaded file is not edited in the portal**: Employee details from an uploaded TXT file cannot be edited in the i-Akaun. You correct them in your payroll system, regenerate the file and upload it again.
- **Maker and Checker accounts**: In the Maker/Checker approval flow a Maker prepares Form A and payments and a Checker approves them. In the non-approval flow an Administrator submits and pays alone, so the account you sign in with decides what a method can finish.
- **Payment methods depend on the employer**: Paying through the bank's website is for Maybank customers, direct debit needs a registered DDA, and Electronic Fund Transfer is for government employers. FPX is listed for the non-approval flow.

## More in Government: East and South-East Asia, Oceania

- [登記情報提供サービス](https://fous.com/automate/registry-information-service.md)
- [Cổng thông tin hóa đơn điện tử](https://fous.com/automate/hoadondientu.md)
- [SIPP Online](https://fous.com/automate/sipp-online.md)
- [Edabu](https://fous.com/automate/edabu.md)
- [PhilHealth EPRS](https://fous.com/automate/philhealth-eprs.md)
- [Virtual Pag-IBIG for Employers](https://fous.com/automate/virtual-pag-ibig-for-employers.md)
- [自然人电子税务局（扣缴端）](https://fous.com/automate/natural-person-e-tax-bureau-withholding.md)
- [eMPF Platform](https://fous.com/automate/empf-platform.md)
- [My.SSS Employer Portal](https://fous.com/automate/my-sss-employer-portal.md)
- [SSO e-Service](https://fous.com/automate/sso-e-service.md)
- [BIR eFPS](https://fous.com/automate/bir-efps.md)
- [RD e-Filing](https://fous.com/automate/rd-e-filing.md)
- [全国统一规范电子税务局](https://fous.com/automate/china-e-tax-bureau.md)
- [Coretax DJP](https://fous.com/automate/coretax-djp.md)
- [myIR](https://fous.com/automate/myir.md)
- [MyTax](https://fous.com/automate/mytax.md)

Other industries: [MCA21](/automate/mca21), [Cvent Supplier Network](/automate/cvent-supplier-network), [Declaración en Línea (F.931)](/automate/declaracion-en-linea-f-931), [ICP Smart Services](/automate/icp-smart-services), [EPREL](/automate/eprel), [Urssaf compte employeur](/automate/urssaf-compte-employeur).

## Frequently asked questions

### Does KWSP i-Akaun (Majikan) have an API?

Not one that payroll software connects to. Payroll providers produce Form A as a TXT or CSV file that you upload under Submit Contributions, then you pay through the bank's website, FPX, direct debit or Electronic Fund Transfer. Contribution records, payment history, statements and receipts are in the portal.

### Which contribution month do I choose when I submit Form A?

The month after the salary month. Salaries for August are submitted as the September contribution. Choosing the wrong month means the payment may not be processed correctly and the file has to be uploaded again for the right month.

### What is the User ID for the employer i-Akaun?

Your EPF employer number. It goes in the User ID field when you activate the account for the first time and when you sign in, after which the portal shows your Secret Phrase and asks for your password.

### How do I check that an EPF payment went through?

Look at the payment history in the contribution records of the employer i-Akaun, where you also download payment receipts. If a payment is missing, check the receipt and your bank's status, then contact KWSP with the reference number.

### Is Fous affiliated with Kumpulan Wang Simpanan Pekerja?

No. Fous is an independent product. You use it with your own i-Akaun (Employer) account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of KWSP i-Akaun (Majikan) (Kumpulan Wang Simpanan Pekerja (Employees Provident Fund)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.
