Merchant Syncing

Celar allows PSPs to onboard and manage their merchants by syncing them in batches. Each merchant is uniquely identified and linked to your PSP account.

1. Sync Merchants

Use the POST /merchants/sync endpoint to upsert one or more merchants at once.

Request Body

{
  "merchants": [
    {
      "external_id": "abc123",
      "name": "CryptoMart",
      "email": "hello@cryptomart.com",
      "business_id": "CM-01"
    },
    {
      "external_id": "xyz789",
      "name": "StablePay",
      "email": "ops@stablepay.io",
      "business_id": "SP-09"
    }
  ]
}

• external_id: Your internal reference for this merchant (must be unique per PSP).
• name: Merchant's business name.
• email: Contact email.
• business_id: legal or tax registration ID. Immutable once submitted.

2. Response

{
  "created": 1,
  "updated": 1,
  "merchants": [
    {
      "external_id": "abc123",
      "merchant_id": "merch_001"
    },
    {
      "external_id": "xyz789",
      "merchant_id": "merch_002"
    }
  ]
}

• Celar returns how many merchants were created vs updated.
• You also receive each merchant’s permanent merchant_id, which you'll need when creating payments.

3. Re-Sync Anytime

• You can safely call /merchants/sync multiple times.
• If the external_id already exists, the merchant record will be updated.
• This makes it ideal for syncing daily or updating contact info on the fly.

Use this API to keep your merchant list in sync with your internal systems — Celar handles deduplication and versioning behind the scenes.