How the platform works

This page gives you one place to see how the Zwapgrid platform fits together: who does what, in what order, and where to find the details.

Actors

  • You (The Client) – You build or run the product that needs Your Customer's accounting data. You create consents, invite Your Customer to the Onboarding Flow, and call API.1 to read data.

  • Your Customer – The end user who connects their Accounting System and grants Consent so you can access their data.

  • Zwapgrid – The platform that provides the Consent API, Accounting API, Onboarding Flow, and Client Portal. Zwapgrid connects to Your Customer's Accounting System and normalizes data for you.

Ordered sequence

  1. Get an API key from the Client Portalarrow-up-right.

  2. Create a consent via the Consent API and get a Consent ID.

  3. Generate a One-Time Code (OTC) via the Consent API.

  4. Build the onboarding URL with the Consent ID and OTC, and send Your Customer to the Onboarding Flow.

  5. Your Customer completes the Onboarding Flow and connects their Accounting System (or uploads files via File.1).

  6. Consent status becomes Accepted once they have finished.

  7. You call the Accounting API with the Consent ID and your API key to read their data (invoices, company info, and more).

Implementation checklist

Step
What to do
Where to read more

1

Get API key from Client Portal

2

Create consent (Consent API) and get Consent ID

3

Generate One-Time Code (Consent API)

4

Build onboarding URL with Consent ID + OTC

5

Your Customer completes Onboarding Flow

6

Check consent status until Accepted

7

Call Accounting API with Consent ID + API key

For full endpoint details and URL structure, see the API Referencearrow-up-right.

Last updated

Was this helpful?