Skip to main content

PSPs & Merchants

Celar is built around Payment Service Providers (PSPs) who onboard and manage their own merchants.

PSPs​

  1. Each PSP registers once and receives a unique psp_id.
  2. PSPs can sync one or more merchants using the /merchants/sync endpoint.
  3. All actions — such as creating payments or managing merchants — are scoped to that psp_id.

Merchants​

  1. Merchants are external businesses managed under a PSP.
  2. They do not directly access Celar; all operations are mediated through the PSP account.
  3. Each merchant has a Celar-generated merchant_id and a PSP-defined external_id.

Syncing Merchants​

  1. Use POST /merchants/sync to create or update merchants in batches.
  2. Merchants can be re-synced at any time without duplication.

This structure gives PSPs full control over their merchant network while ensuring clear data boundaries and operational separation.