Skip to main content
POST
/
api
/
v1
/
processors
Create Processor
curl --request POST \
  --url https://api.example.com/api/v1/processors \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "phone_number": "<string>",
  "email": "<string>",
  "password": "<string>"
}
'

​
Create Processor

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

​
Endpoint

POST /api/v1/processors

​
Authentication

​
Authorization
string
required
Bearer token (Admin JWT)

​
Request Body

​
name
string
required
Business name
​
phone_number
string
required
Contact phone number
​
email
string
required
Email address for login
​
password
string
required
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

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