curl --request POST \
--url https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/transactions \
--header 'Content-Type: application/json' \
--header 'secretKey: <api-key>' \
--data '
{
"productCode": "300",
"clientReference": "uat_tx_elec_1790769719777",
"amount": 1000,
"data": {
"accountNumber": "0219927013063",
"phoneNumber": "08012345678"
}
}
'{
"status": "00",
"message": "Transaction successful",
"data": {
"transactionRef": "uat_tx_1790769719777",
"token": "4819-2049-1829-4019-3382",
"units": "34.5 kWh",
"amount": 1000,
"status": "SUCCESS"
}
}Remita VAS Vending
Make Vending Transaction
Execute bill payment, token purchase, or mobile airtime/data top-up.
POST
/
vending
/
transactions
curl --request POST \
--url https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/transactions \
--header 'Content-Type: application/json' \
--header 'secretKey: <api-key>' \
--data '
{
"productCode": "300",
"clientReference": "uat_tx_elec_1790769719777",
"amount": 1000,
"data": {
"accountNumber": "0219927013063",
"phoneNumber": "08012345678"
}
}
'{
"status": "00",
"message": "Transaction successful",
"data": {
"transactionRef": "uat_tx_1790769719777",
"token": "4819-2049-1829-4019-3382",
"units": "34.5 kWh",
"amount": 1000,
"status": "SUCCESS"
}
}Execute a value-added service purchase. If vending electricity, the 20-digit token is returned in the response upon success.
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
productCode | string | Yes | Biller product code (300 for AEDC Electricity, 111 for MTN Data, etc.). |
clientReference | string | Yes | Your unique merchant transaction reference for idempotency. |
amount | number | Yes | Transaction amount in Naira (e.g. 1000). |
data.accountNumber | string | Yes | Customer meter number, phone number, or account ID. |
data.phoneNumber | string | Yes | Recipient phone number for token/receipt SMS delivery. |
Request Example (Electricity Vend)
curl --location 'https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/transactions' \
--header 'secretKey: sk_test_l/pQgOLgziOTzb+7pcUXVH2iX1MlpROsePDkNi/g/QmMs2c8P0DPr1vUP7xESiGG' \
--header 'Content-Type: application/json' \
--data '{
"productCode": "300",
"clientReference": "tx_ref_1790769719",
"amount": 1000,
"data": {
"accountNumber": "0219927013063",
"phoneNumber": "08012345678"
}
}'
Successful Response (Electricity Token)
{
"message": "successful",
"status": "00",
"data": {
"paymentIdentifier": "PID_99018274619",
"token": "4910-2819-3810-4819-1029",
"unit": "38.5 kWh",
"amount": 1000,
"fee": 0,
"transactionStatus": "SUCCESS"
}
}
Authorizations
Body
application/json