Integration Guide

👋 Hi! Welcome to Duplo API Documentation where you'll learn how to use the Duplo's powerful APIs to automate your business payments. Let's walk you through how to integrate with Duplo APIs.

We wrote these docs assuming you are familiar with APIs and can make API calls.

API Keys

In order to integrate with Duplo, you are required to have a Duplo account and an API key.

👉 Click here to create an account on Duplo, if you don't have one.

👉 Follow the steps below to get your API key.

  • On your dashboard, you'll notice you're automatically in Test mode.

  • Select the settings menu on your dashboard.

  • Click on the Developer tab.

  • Click the copy button beside your API key on the dashboard.

Business ID

When making API calls, you may need to supply the business_id . This is an alphanumeric key we automatically generate for new businesses.

👉 Follow the steps below to get your business_id.

  1. On your dashboard, click on "Settings" and then on "Developer"

  2. Click on the copy icon to copy your business_id to the clipboard.

We have two environments: live and test mode. Please ensure that your account is on test mode when making use of the Test API key. Once you are done with your test, complete our compliance requirements so you can switch your account to live to get your live API key.


Duplo uses API keys to authenticate requests. You can view and manage your API keys on the Duplo Dashboard. Test mode secret keys have the prefix dp_test and live mode secret keys have the prefix dp_live.

Treat your API keys like your credit card because they carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub or Bitbucket, client-side code, and so forth.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Authorization headers should be in the following format: Authorization: Bearer SECRET_KEY

Sample authorization header

Authorization: Bearer dp_test_P2tH90snfuQB0qlPopnhdgkOpbs...

Last updated