> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitpayapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bukku Sync

> Sync your sales, processing fees, and refund data from HitPay to Bukku

## Overview

The HitPay Bukku integration automatically syncs your sales, processing fees, and refund data from HitPay to Bukku. This keeps your books up to date without manual data entry — no complicated OAuth popups, just a direct and secure connection.

### What Gets Synced

* **Sales** — Each charge is recorded as an Invoice and Payment in Bukku
* **Processing Fees** — HitPay fees are mapped to your chosen GL account
* **Refunds** — Refunds are tracked and mapped to your chosen GL account

### Key Features

* Two sync modes: **Bulk** (daily summary) or **Individual** (per charge)
* Map your own Bukku GL accounts for sales, fees, refunds, and payouts
* Secure direct connection using your Bukku Access Token
* Built for Malaysian businesses

***

## Prerequisites

Before connecting, make sure you have:

1. An active **HitPay** account
2. An active **Bukku** account
3. Your **Bukku Company Subdomain** (e.g., `yourcompany` from `yourcompany.bukku.my`)
4. A **Bukku API Access Token** — generate this from **Control Panel → Integrations → Turn ON API Access** in your Bukku account

***

## Connecting Bukku

1. In your HitPay dashboard, go to **Integrations** from the left navigation menu.
2. Click the **Available** tab, then select **Accounting**.
3. Click the **Bukku** card.

<img src="https://mintcdn.com/hitpay/Aeya30DKO2mywl2o/images/connections/bukku-integrations-page.png?fit=max&auto=format&n=Aeya30DKO2mywl2o&q=85&s=6d45696e42e99859e376cc1a3231353a" alt="HitPay Integrations page showing the Accounting section with Bukku" width="1440" height="846" data-path="images/connections/bukku-integrations-page.png" />

4. Enter your **Company Subdomain** — this is the prefix of your Bukku URL (e.g. if your URL is `mycompany.bukku.my`, enter `mycompany`).
5. Enter your **Access Token** — generate this from your Bukku account under **Control Panel → Integrations → Turn ON API Access**.
6. Click **Connect to Bukku**.

<img src="https://mintcdn.com/hitpay/Aeya30DKO2mywl2o/images/connections/bukku-connect.png?fit=max&auto=format&n=Aeya30DKO2mywl2o&q=85&s=46085776c381dde568e227e68b185622" alt="Connect to Bukku form showing Company Subdomain and Access Token fields" width="1440" height="846" data-path="images/connections/bukku-connect.png" />

***

## Configuring Sync Settings

After connecting, configure how data syncs to Bukku before enabling sync.

1. On the Bukku integration page, open the **Settings** modal.

2. **Map your accounts.** Select the Bukku GL accounts that HitPay should use for each type of transaction:

   | Setting                 | Purpose                                 |
   | ----------------------- | --------------------------------------- |
   | **Sales Account**       | Records your sales revenue              |
   | **Fee Account**         | Records HitPay processing fees          |
   | **Refund Account**      | Records refund entries                  |
   | **Bank Payout Account** | Tracks settlements to your bank account |

3. **Choose your Invoice Grouping mode:**

   * **Bulk** *(default)* — Combines all transactions from each day into one clean summary. Best for high-volume businesses that prefer a summarized view.
   * **Individual** — Creates a separate invoice record for every transaction. Best for businesses that need per-transaction detail in Bukku.

4. **Enable the sync toggle** to start syncing data to Bukku.

5. Click **Save** to apply your settings.

<Warning>Only charges created **after** sync is enabled will be synced. Historical charges are not retroactively synced.</Warning>

***

## Disconnecting Bukku

1. On the Bukku integration page, click the **Disconnect** button.
2. A confirmation dialog will appear. Click **Disconnect** to confirm.

Your sync history will be preserved after disconnecting. You can reconnect at any time.

***

## Important Notes

* **Only future charges are synced.** Syncing begins from the moment you enable sync. Past charges are not retroactively synced.
* **Re-enabling sync after disabling** only syncs new charges going forward. Charges that occurred while sync was off are skipped.
* **One HitPay business connects to one Bukku account.** Each business account requires its own Bukku connection.

***

## FAQs

<AccordionGroup>
  <Accordion title="Where do I find my Bukku Access Token?">
    Log in to your Bukku account, then go to **Control Panel → Integrations** and turn on **API Access**. Your access token will be displayed there.
  </Accordion>

  <Accordion title="Why are some charges missing in Bukku?">
    Check the following:

    1. **Sync is enabled** — Verify the sync toggle is turned on in Settings.
    2. **Charge timing** — Only charges created after sync was enabled are synced. Charges from before that date are not included.
    3. **Last sync time** — Check the "Last Sync" timestamp on the integration page. If the last sync was before the charge was created, wait for the next automatic sync or trigger a manual sync.
  </Accordion>

  <Accordion title="What is the difference between Bulk and Individual sync?">
    **Bulk** combines all transactions from a given day into one daily summary entry in Bukku, which is ideal for businesses with high transaction volumes. **Individual** creates a separate record for each transaction, giving you per-transaction visibility in your Bukku account.
  </Accordion>
</AccordionGroup>