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"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'merchant@smartpay.sl',
name: 'Smart PAY Merchant',
password: 'SecurePass123',
phone_number: '0771234567'
})
};
fetch('https://olive-gateway-a6ba.onrender.com/api/v1/processors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://olive-gateway-a6ba.onrender.com/api/v1/processors"
payload = {
"email": "merchant@smartpay.sl",
"name": "Smart PAY Merchant",
"password": "SecurePass123",
"phone_number": "0771234567"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{}{}Processors
Create Processor
Register a new payment processor
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"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'merchant@smartpay.sl',
name: 'Smart PAY Merchant',
password: 'SecurePass123',
phone_number: '0771234567'
})
};
fetch('https://olive-gateway-a6ba.onrender.com/api/v1/processors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://olive-gateway-a6ba.onrender.com/api/v1/processors"
payload = {
"email": "merchant@smartpay.sl",
"name": "Smart PAY Merchant",
"password": "SecurePass123",
"phone_number": "0771234567"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{}{}Create Processor
Register a new payment processor (merchant) with subscriber account and API credentials.Endpoint
POST /api/v1/processors
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
{
"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
- Processor record in database
- System user account for dashboard login
- API key for POS integration
- HMAC secret for request signing
- WhatsApp notification with credentials
Errors
| Code | Description |
|---|---|
| 400 | Invalid request or email already exists |
| 401 | Unauthorized |
| 500 | Internal server error |
Authorizations
JWT token from admin login for administrative operations. Format: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
Body
application/json
Processor details
Response
Processor created successfully
The response is of type object.
⌘I