Skip to main content
POST
Create new payment processor

Create Processor

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

Endpoint

Authentication

string
required
Bearer token (Admin JWT)

Request Body

string
required
Business name
string
required
Contact phone number
string
required
Email address for login
string
required
Initial password (min 6 characters)

Response

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

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.