Help

Getting started

Install the app from the e-conomic Marketplace. You will be redirected here to finish setup in three steps:

1. Connect e-conomic — we use e-conomic's secure grant-token model. Your e-conomic password is never stored.
2. Connect AltaPay — add your gateway URL, username, and password. Fundings are polled on sync (no webhook).
3. Map accounts — choose your cashbook journal, fee, net, difference (rounding), and optional clearing account.

When setup is complete, the Home dashboard shows a green status banner and you can run your first sync.

Home dashboard

Home is your overview after login. The status banner at the top reflects the current state of your setup and sync:

• All good — last sync completed successfully. Use Process fundings when new fundings are available.
• Sync in progress — a sync is running. The banner updates automatically while payments are imported.
• Needs attention — failed funding downloads or payments that are not yet resolved. Open Sync or Activity with the Needs attention filter.
• e-conomic access lost — reconnect in Settings before syncing again.
• Setup checklist — shown until e-conomic, AltaPay, account mapping, and your first funding are complete.

When AltaPay is connected, the funding inbox card shows pending, failed, or ready-to-process fundings. Below the banner you will see connection status, sync statistics (last 30 days), the next scheduled run (if enabled), and a table of recent sync runs. Click any run to open its detail page.

Connections

e-conomic

The app needs permission to read invoices and create cashbook vouchers in your e-conomic agreement. After you log in, open Settings → Connections.

• Reconnect — use this if e-conomic access was revoked or expired.
• Disconnect — removes the grant token from this app. Uninstalling from the Marketplace also revokes access immediately.

AltaPay

In the AltaPay merchant portal, note your gateway URL, API username, and password for a user that can call fundingList and fundingDownload. Paste them in Settings → Connections and save. Credentials are encrypted — no webhook setup is required.

Accounting mapping

Each synced AltaPay settlement line becomes a balanced cashbook voucher in e-conomic:

• Gross — customer payment matched to a booked invoice, or posted to a clearing account when invoice matching is off.
• Fee — card/acquirer fees from the funding file (fixed fee, rate-based fee, VAT).
• Net — settlement amount deposited to your bank (Settlement Amount in the funding file).
• Difference — only when the invoice gross amount does not exactly match the payment gross (rounding).

From the funding file we import payment and refund rows. Other row types are ignored.

Invoice matching mode

Choose how payments without a booked invoice are handled:

• Require booked invoice — matches AltaPay Order / merchant reference to the e-conomic invoice Other reference field. If your shop does not put the order/invoice id there, use flexible mode instead.
• Allow payments without invoice — unmatched gross amounts post to a clearing account you choose. Useful when not every payment has an invoice yet.

Accounts to map

• Cashbook journal — where vouchers are created.
• Difference account — small rounding when payment gross ≠ invoice gross.
• Fee account — AltaPay transaction fees per settlement line.
• Net / bank account — the net settlement amount deposited to your bank.
• Clearing account — only required in flexible invoice mode.

Account numbers depend on your chart of accounts. If you are unsure, ask your accountant before saving.

Sync

Open Sync in the app to process available fundings. The app works in two steps:

1. Ingest fundings — AltaPay fundingList / fundingDownload (or CSV upload); payment and refund rows become settlement lines.
2. Post to e-conomic — each payment is turned into a cashbook voucher using your account mapping.

Already-imported payments are skipped automatically — re-running a sync does not create duplicates in e-conomic. You can also upload a funding CSV manually if a download was missed.

Process fundings

Click Process fundings to poll AltaPay, download new files, and post new lines. Date range is optional under Advanced.

Scheduled sync

In Settings → Schedule, choose daily or weekly automatic sync and the time of day. The Home dashboard shows when the next run is due.

Activity

The Activity page shows your payment timeline and sync history in one place. Filters and paging update instantly without reloading the whole page.

Filters and search

• All — individual payments plus sync history below.
• Sync history — hide payments and show only the list of sync jobs.
• Needs attention — payments that failed and still need your action.
• Search — type a payment or settlement reference; results update as you type.

Payments

Each row is one payment from a AltaPay settlement report. You see the reference, status, time, and settlement batch. Use Payload to inspect raw payment, settlement, and e-conomic voucher data when troubleshooting. Actions appear on failed or synced payments:

• Retry — try again to post this payment to e-conomic (for example after you booked the missing invoice). A short confirmation toast appears when done; the list refreshes automatically.
• Resolve — hide the error when you handled it outside the app (for example, entered the voucher manually in e-conomic).
• Resolve all — available on the Needs attention filter to clear every open error at once.
• Force retry — on already-synced or skipped payments only. Use with care: this may create a duplicate voucher in e-conomic. The app asks you to confirm first.

Sync history

The table at the bottom lists each sync job with scope (all reports or a date filter), trigger (manual, scheduled, or CSV import), and result counts. Click a row to open the sync run page with every payment in that job and a Retry processing option when errors occurred.

The Home banner counts only unresolved errors — successfully retried or manually resolved payments no longer increase the attention count.

Settings

Settings is organised in tabs on the left (or a dropdown on mobile). Switch tabs without leaving the page; the URL updates so you can bookmark a section (for example ?tab=schedule). When you save a form, changes are sent in the background and a toast notification confirms success or shows an error.

Connections

Connect, reconnect, or disconnect e-conomic and AltaPay.

Accounting

Invoice matching mode and account mapping.

Schedule

Automatic sync frequency and time.

General

Company display name and timezone.

Notifications

Email alerts when a sync has errors or warnings.

Security

Change your login password.

Sidebar tip: use the arrow at the bottom of the left menu to collapse it. Your preference is remembered on this browser.

Troubleshooting