Create Processor

POST/processorsOpen in the API playground →

Register a new payment processor (merchant) with subscriber account and API credentials.

Endpoint

POST /api/v1/processors

Authentication

Authorizationstringheaderrequired

Bearer token (Admin JWT)

Request Body

namestringbodyrequired

Business name

phone_numberstringbodyrequired

Contact phone number

emailstringbodyrequired

Email address for login

passwordstringbodyrequired

Initial password (min 6 characters)

Response

{
  "success": true,
  "processor_id": "proc_abc123",
  "message": "Processor created successfully",
  "api_key_id": "key_xyz789",
  "api_key": "olive_pos_live_xxxxxx",
  "hmac_secret": "secret_xxxxxx",
  "warning": "IMPORTANT: Save the API key and HMAC secret - they will not be shown again!"
}

What Gets Created

1. Processor record in database
2. System user account for dashboard login
3. API key for POS integration
4. HMAC secret for request signing
5. WhatsApp notification with credentials

Errors

Code	Description
400	Invalid request or email already exists
401	Unauthorized
500	Internal server error