Data Requirements
Celar collects only the minimal data required to support secure routing, compliance, and settlement. PSPs are responsible for ensuring this data is accurate and up to date.
PSP Information
Each Payment Service Provider must provide:
| Field | Required | Description |
|---|---|---|
business_name | ✅ | Registered name of the PSP |
contact_email | ✅ | Admin or compliance contact |
registered_country | ✅ | Country of incorporation (ISO-3166) |
license_number | ✅ | Busiess registered license |
Merchant Data
Submitted via /merchants/sync, every merchant must include:
| Field | Required | Description |
|---|---|---|
external_id | ✅ | Your internal merchant reference |
name | ✅ | Legal or trade name |
email | ✅ | Contact email |
business_id | ✅ | Business registration or license ID |
country | ✅ | Country of registration (ISO-3166 format) |
Payment Metadata
Every payment initiated via Celar must include:
| Field | Required | Description |
|---|---|---|
merchant_id | ✅ | ID returned from merchant sync |
amount | ✅ | Amount in stablecoin (e.g., 10.00) |
currency | ✅ | USDC or USDT |
chain | ✅ | base, polygon, arbitrum, or best |
metadata | ⛔ | Optional JSON (e.g., order ID, invoice note) |
Data Usage
All submitted data is:
- Stored securely and encrypted at rest
- Used only for routing, risk checks, settlement, and audit trails
- Never shared with third parties without consent
Celar is designed with a privacy-by-default philosophy — we collect only what’s essential to keep payments safe, fast, and compliant.