Skip to main content

Choose your integration


Prerequisites

Before you begin, make sure you have:

  • A Banqup accountRegister here
  • API credentials (Client ID & Secret) → Create client credentials
  • Basic knowledge of REST APIs and HTTP requests
  • A tool to make API calls: curl, Postman, or your preferred programming language


Step 1: Identify your integration use case and authentication flow

Before you start coding, it's important to understand which integration type you need and its corresponding OAuth 2.0 flow.


A. Workflow integrations and automations

Authentication flow: Client Credentials Grant


This is the most common flow for:

  • Integrating Banqup with your internal ERP/accounting system
  • Automating invoice processing for your company
  • Syncing data between Banqup and your own applications
  • Building integrations for the Banqup Store (marketplace)

Example use case: "We want to automatically sync invoices from Banqup to our QuickBooks instance."

How it works:

  1. Your application uses a Client ID and Client Secret
  2. Exchange credentials directly for an access token
  3. No user interaction required
  4. Your business owner must whitelist your application ID

Check out how to make your first API call using the Client Credentials Grant flow.



B. Customer-facing integrations

Authentication flow: Authorization Code Grant (OAuth User Flow)


This flow is for:

  • SaaS applications offering Banqup integration to customers
  • Multi-tenant platforms where each customer connects their own Banqup account
  • Apps where users authenticate with their Banqup credentials

Example use case: "We're a SaaS accounting platform and want to let our customers connect their Banqup accounts."

How it works:

  1. User clicks "Connect to Banqup" in your app
  2. User is redirected to Banqup login page
  3. User grants your app permission to access their data
  4. Your app receives an authorization code
  5. Exchange code for access token

Check out how to implement OAuth user flow.



Step 2: Choose your integration path


E-Invoicing Integration

For a better understanding on how our invoice lifecycle works, check out the following guides:


To start integrating automated invoicing workflows, check out these recipes:


Payments Integration

To learn more about the Banqup Payments services, check out these guides:



To start integrating automated payments workflows, check out these recipes:


Platform Integration

For a clearer view on how to integrate with core Banqup services, see the guides below:



To start setting up real-time events, check out this recipe:


Advanced Authentication

To implement user-level authentication, check out these recipes.




Development Resources

Key Concepts


Entity: Represents a company/organization in Banqup
Space: A workspace within an entity (e.g. certain sub-brand or branch)
User: Individual with access to entities and spaces



Feedback & Contribution

Help Us Improve

Is something unclear? Found an error? Help us improve this guide!

Share Your Experience

Built something cool with Banqup APIs? We'd love to hear about it!

  • Share your integration story
  • Contribute code examples
  • Write a guest blog post

Contact: support@banqup.com