Darbpay’s Wafeq integration connects your card spend directly to your Wafeq accounting, using your own chart of accounts and tax setup.

Once connected, Darbpay will:

• Import Wafeq expense accounts and map them to Darbpay expense categories

• Import Wafeq tax codes and make them available for mapping to categories

• Export card expenses, account statements, and receipts into a dedicated Wafeq bank account for Darbpay cards

This article covers:

• How the Wafeq integration works

• How to connect Wafeq to Darbpay (OAuth flow)

• How to import tax codes & accounts from Wafeq

• How to map Darbpay wallets to Wafeq bank accounts

• How Darbpay expenses appear inside Wafeq

• Common questions (FAQs)

How the Wafeq integration works

Behind the scenes, the integration is designed around two main flows:

1. One-time metadata sync (import into Darbpay)

• Wafeq expense accounts are imported and mapped to Darbpay expense categories

• Wafeq tax codes are imported and mapped to Darbpay tax codes

2. Ongoing export (from Darbpay into Wafeq)

• Darbpay exports account statements, card expenses, and receipts into a dedicated Wafeq bank account for Darbpay cards

• Exports use the stored mappings:

  • Expense category ↔ GL account ↔ tax code

This ensures every transaction exported to Wafeq lands in the right account with the right VAT and a linked receipt.

Accessing the Wafeq integration in Darbpay

You can find the Wafeq integration under:

Settings → Accounting integrations → Wafeq

On this page you’ll see:

• Integration status (Not connected / Connected)

• The Wafeq organization that Darbpay is currently linked to

• A shortcut to the Accounting setup wizard

• A summary of recent exports and any errors

The setup wizard follows a 5-step flow: Connect → Tax Codes → Expense Accounts → Bank Account → Finish.

Step 1: Connect Darbpay with Wafeq

1. Click Connect with Wafeq from the Wafeq integration card.

2. You’ll be redirected to Wafeq’s secure OAuth page.

On the Wafeq page:

• Choose the Wafeq Organization you want to link to Darbpay (e.g., “Darb”).

• Review the permissions Darbpay will receive, which typically include read/write access to:

  • Organization info & user list

  • Chart of accounts

  • Bank accounts

  • Cash expenses

  • Contacts & employees

  • Tax rates

  • Manual journals

• Click Connect to grant access (or Cancel to abort).

After you confirm, Wafeq redirects you back to Darbpay. In the background:

• Darbpay exchanges the authorization code for access

• The chosen Wafeq organization ID are stored securely and encrypted

• The integration status is updated to Connected, and the wizard moves automatically to Tax Codes

Step 2: Import Wafeq tax codes into Darbpay

Once connected, you’ll land on the Tax Codes step.

Here you’ll see a table that mirrors your Wafeq VAT/tax configuration, including:

• Tax Name

• Internal Tax Code

• Tax Rate %

• Status (Active)

Darbpay calls Wafeq’s Tax Rates API and imports the full list of tax codes for the selected organization. These codes are:

• Stored in Darbpay’s tax model

• Flagged as coming from Wafeq

• Available for mapping to Darbpay expense categories

Existing tax settings in Darbpay for that company can be replaced or merged, depending on your configuration, but Wafeq remains the source of truth for VAT.

Step 3: Import and map Wafeq expense accounts

Next, you move to the Expense Accounts step.

1. Click Import Expense Accounts from Wafeq.

2. Darbpay calls Wafeq’s Chart of Accounts API and fetches all GL accounts.

3. Only relevant expense-type accounts (based on Wafeq’s account type) are shown in the mapping UI.

For each account, Darbpay stores:

• Wafeq account ID

• Account name

You can then map:

• Each Darbpay expense category to a specific Wafeq expense account 
  

• These mappings are used whenever Darbpay builds accounting entries for export into Wafeq.
  

Step 4: Choose Wafeq bank accounts for Darbpay card settlements

The Bank Account step defines where Darbpay card settlements will land inside Wafeq.

You have two options:

Option 1: Use a single bank account

• Select an existing Wafeq bank account from the dropdown, for example:

  • Bank Account

  • Undeposited Funds

  • Petty Cash

• Or create a new bank account in Wafeq specifically for Darbpay if one doesn’t exist yet.

Option 2: Map wallets to multiple bank accounts

If you operate different business units or entities, you can map each Darbpay sub-wallet/card to a different Wafeq bank account:

• Click Map wallets to Bank Accounts

• For each wallet/sub-wallet, choose the Wafeq bank account it should post to

On save, Darbpay stores:

• The default bank account ID for settlements

• (If configured) the mapping of each wallet/sub-wallet → specific Wafeq bank account ID

These mappings are then used to construct the correct accounting entries for each export.

Step 5: Finish setup

On the Finish step, you’ll see a summary of your configuration:

• Connected Wafeq organization

• Imported tax codes & expense accounts

• Default bank account and any wallet-specific mappings

You can always revisit the Wafeq integration page later to:

• Refresh tax codes or accounts

• Adjust mappings for categories or wallets

• Disconnect and reconnect Wafeq if needed

How Darbpay exports appear in Wafeq

After setup, Darbpay exports your approved, exportable card activity into Wafeq using the mappings you’ve configured.

For each transaction:

• Darbpay calls Wafeq APIs to create the necessary accounting entries (expense / journal lines) with:

  • The mapped expense account (e.g., “530 Darbpay Expenses”)

  • The mapped bank/clearing account

  • The mapped tax code and VAT amounts

• Once Wafeq confirms creation, Darbpay marks the transaction as Exported and stores the Wafeq document ID for deep-linking if needed.

Inside Wafeq:

• Card expenses appear in your Profit & Loss under the GL accounts you mapped (e.g., “530 Darbpay Expenses”, “Fuel”, “Travel”, “Office Supplies”).

• Reports show monthly totals and roll them up into Operating Expenses and Net Profit.

• If you mapped multiple categories to different GL accounts, each appears on its own line in Wafeq’s P&L and related reports.

This means Darbpay spend naturally flows into Wafeq’s standard dashboards and financial reports, there is no manual re-entry.

FAQs

What data does Darbpay access in Wafeq?

When you connect Wafeq, you explicitly grant Darbpay permission to access:

• Organization information and user list

• Chart of accounts

• Bank accounts

• Cash expenses

• Contacts & employees

• Tax rates

• Manual journals

Darbpay uses this access to:

• Import tax codes and GL accounts for mapping

• Create the accounting entries needed to record Darbpay card expenses

Does Darbpay change my chart of accounts or tax rates in Wafeq?

No. Darbpay reads your chart of accounts and tax rates to use them as a source of truth. It does not modify your existing accounts or tax rules.

The only optional write operation is when you choose to create a dedicated bank account in Wafeq for Darbpay during the Bank Account step. Otherwise, Darbpay posts into bank accounts you already have.

Can I map different wallets or departments to different bank accounts?

Yes.

Using the Map wallets to Bank Accounts option, you can:

• Link each Darbpay wallet/sub-wallet to its own Wafeq bank account

• Reflect different entities, branches, or cost centers directly through bank-account-level mapping

Future exports will follow these mappings automatically.

What happens if I change my mappings later?

If you change:

• Category → account / tax code mappings, or

• Wallet → bank account mappings

These changes affect future exports only. Transactions already exported to Wafeq will remain unchanged; if you need to adjust those, you should edit them directly inside Wafeq according to your internal policy.

How do I disconnect Wafeq from Darbpay?

From the Wafeq integration page:

• Use the Disconnect access option.
  

• You can reconnect at any time by running the Connect with Wafeq step again.