Metadata

What it is

Metadata is a flat key-value object that can be attached to certain resources, such as Customers and Sales, to store additional merchant-defined information.

Why it exists

It exists to let you extend the API resource with your own identifiers or business context without changing the core schema. This is useful for storing integration-specific values that the standard contract does not model directly.

How it relates to other concepts

Metadata is not a standalone resource. It is embedded inside other concepts, most clearly Customer and Sale. It helps link Buckaroo resources to external systems, internal references, or custom workflow data while keeping the main resource structure unchanged.