Setup your Customers

Here, we’ll introduce you to the concept of a Customer on the Bud platform.

The basics

When we refer to a Customer, we’re talking about the end-user of your and Bud’s technology. Customer entities in Bud have unique identifiers and this is used to store the customer data on the Bud platform.

Some examples of the type of data that can be stored against a customer record include:

• account information (accounts, balances, and transactions) that you ingested through one of Bud’s aggregation services, e.g. first party ingester;
• enrichment and insight information that has been applied to or identified from a Customer’s financial data.

A Customer record can be simply created and deleted via the Customer API. In the sandbox environment, you can create as many Customers as you like free of charge. However, the sandbox only permits the use of dummy data.

👍

Sandbox

In the sandbox, you can create an unlimited number of Customers for free. However, the sandbox only permits the use of dummy data.

Registering Customers

Register Customers on the Bud platform via the POST platform/v3/customers endpoint (here). Set the region and locale in the request body based on your Customer location, for example region = "US" and locale = "en-us".

Example response:

{
    "operation_id": "platform_v3_customers_post",
    "data": {
        "customer_id": "1c3e875c-1195-4c03-a05a-3b6a115a4f0c",
        "customer_context": {
            "type": "personal",
            "other_fields": "..."
        }
    }
}

Usually, you can rely on the default values of the customer context that are populated, but for example if you wish to set a different region for your customer you can do it with the following request body:

{
  "customer_context": {
    "region": "UK",
    "locale": "en-gb"
  }
}

which will yield the following response:

{
    "operation_id": "platform_v3_customers_post",
    "data": {
        "customer_id": "1c3e875c-1195-4c03-a05a-3b6a115a4f0c",
        "customer_context": {
          "type": "business",
          "other_fields": "..."
        }
    }
}

The customer_id is used as a unique identifier for that Customer and is required in all API endpoints that relate to a given customer.

Batch Creation of Customers

In almost all use-cases, we expect you to create customers individually at the point of sign-up, using the POST platform/v3/customers endpoint.

However, there are certain use-cases that may require the creation of customers in a batch. For this reason, we also offer the POST platform/v3/customers/batch endpoint which allows for a more efficient customer creation process if needed. You may need this endpoint if you are migrating an existing customer data set into the Bud platform.

Billing of Customers

Most clients of Bud will be billed by the number of customers that they have on the Bud platform. Therefore if you have customers whom you no longer require data for or who have not connected an account, it is imperative that you remove them from the Bud platform in order to avoid being billed for them.

We recommend running a script once a month to remove any inactive or obsolete customers.

Removing Customers

Removing (or de-registering) a Customer can be simply achieved through the use of the DELETE /v1/customers/{customer_id} endpoint (here). As well as removing the Customer record, this will completely delete of all data related to that Customer.

If you have any questions, please contact us via the chatbot (bottom-right of screen 👉) or via a support request or check our FAQs.