Docs
Basics
API Reference
Basics
API Reference
  1. Merchant Dashboard
  • Introduction
  • Merchant Dashboard
    • Get Started
    • What is Branches
    • What is Vault and how Settlement works
  • Pay with Woldy
    • How to Pay with Woldy
  1. Merchant Dashboard

What is Branches

Branch is an operating unit created inside a Company in Woldy.
Each Branch is a separate payment context with its own financial components and settlement logic.
When a business wants to split operations by store, region, brand, or team, it does so through Branches.

How Branches work#

A Branch is created under a Company.
Each Branch has its own:
Wallet
Vault
Settlement logic
This means a Branch operates as an independent unit for accepting payments and managing how funds are settled.

Payment ownership#

Every Payment in Woldy always belongs to a specific Branch.
A payment is never created without branch context.
This makes the Branch the core operational layer for:
payment creation
payment tracking
settlement execution
branch-level reporting

What belongs to a Branch#

Wallet#

Each Branch has its own Wallet used within its payment flow.

Vault#

Each Branch has its own Vault for holding and processing branch-related funds.

Settlement logic#

Each Branch has its own settlement configuration and rules.
This allows different Branches to operate with different settlement behavior depending on business needs.

Payments#

All payments are created and stored at the Branch level.
A payment always belongs to one specific Branch.

Why Branches exist#

Branches let a Company separate operations across different business units while keeping one shared company structure.
Typical examples:
different stores
different regions
different products
different brands
different internal teams
Each of these can operate through its own Wallet, Vault, and settlement setup.

Summary#

A Branch is a payment and settlement unit inside a Company.
It is created under the Company and includes:
its own Wallet
its own Vault
its own settlement logic
Every Payment in Woldy always belongs to a specific Branch.
Modified at 2026-04-14 06:29:33
Previous
Get Started
Next
What is Vault and how Settlement works
Built with