Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.bitwage.com/llms.txt

Use this file to discover all available pages before exploring further.

Account types

Bitwage Business

A company account that invites users as “Workers” to receive payroll or invoice payments. Requires KYC for the business entity and business admins only.

Bitwage Individual

A user account where the user adds their employers or clients by providing Bitwage’s banking details to them. Requires KYC for the user.

Bitwage Worker

A user account created when a user is invited to join a Business account as a “Worker” to receive payroll or send invoices. Does not require KYC.

Bitwage Business Admin

A user who manages a Business Account. Can also receive payroll or send invoices to the Business Account. Requires KYC.

Key concepts

Distribution

A distribution defines how a user receives their payment. It specifies the ratio of different output currencies. For example, a user could set up a distribution of 50% Bitcoin and 50% USD. Users can have up to 3 distributions, and the total allocation across all distributions must equal 100%.

Payer (External Company)

A payer represents an employer or client that sends payments to a Bitwage Individual user. Payers can use USD or EUR on the Bitwage platform. Through the Partner API, payers must use EUR.

Funding Account

A virtual bank account assigned to a user for receiving payments from a specific payer. The account details (account number, routing number, IBAN, etc.) are provided to the payer so they can deposit funds. Through the Partner API, funding accounts can be created for EUR payers only. USD funding accounts are not supported.

Payroll (Payment Batch)

A payroll is a batch of payments created by a Business account to pay one or more workers or vendors. Payrolls progress through these statuses: pendingreceivedreleasedfulfilled

KYC / KYB

  • KYC (Know Your Customer): Identity verification for individual users.
  • KYB (Know Your Business): Verification for company entities, including UBO (Ultimate Beneficial Owner) verification.

Recipient

A company recipient is either a worker (contractor/employee) or a vendor linked to a Business account. Recipients can be created with or without requiring a Bitwage login.