Skip to main content
POST
/
processors
Create new payment processor
curl --request POST \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/processors \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "merchant@smartpay.sl",
  "name": "Smart PAY Merchant",
  "password": "SecurePass123",
  "phone_number": "0771234567"
}
'
{}

Documentation Index

Fetch the complete documentation index at: https://docs.vultlocal.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

Authorizations

​
Authorization
string
header
required

JWT token from admin login for administrative operations. Format: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Body

application/json

Processor details

​
email
string
required
Example:

"merchant@smartpay.sl"

​
name
string
required
Example:

"Smart PAY Merchant"

​
password
string
required
Minimum string length: 6
Example:

"SecurePass123"

​
phone_number
string
required
Example:

"0771234567"

Response

Processor created successfully

The response is of type object.