> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handle.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Make Vending Transaction

> Execute bill payment, token purchase, or mobile airtime/data top-up.

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)

```bash theme={null}
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)

```json theme={null}
{
  "message": "successful",
  "status": "00",
  "data": {
    "paymentIdentifier": "PID_99018274619",
    "token": "4910-2819-3810-4819-1029",
    "unit": "38.5 kWh",
    "amount": 1000,
    "fee": 0,
    "transactionStatus": "SUCCESS"
  }
}
```


## OpenAPI

````yaml remita_openapi.json POST /vending/transactions
openapi: 3.0.3
info:
  title: Remita (SystemSpecs) VAS & Collection API
  description: >-
    Interactive API specification for Remita / SystemSpecs Connect Gateway VAS
    Vending, Utilities, and RRR Biller Collections.
  version: 1.0.0
servers:
  - url: https://api-demo.systemspecsng.com/services/connect-gateway/api/v1
    description: Sandbox / Demo Environment (UAT)
  - url: https://api-gateway.remita.net/api/v1
    description: Production Live Environment
security:
  - SecretKey: []
paths:
  /vending/transactions:
    post:
      summary: Make Vending Transaction
      description: Execute bill payment, token purchase, or airtime/data topup.
      operationId: makeTransaction
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - productCode
                - clientReference
                - amount
                - data
              properties:
                productCode:
                  type: string
                  default: '300'
                  example: '300'
                clientReference:
                  type: string
                  default: uat_tx_1790769719777
                  example: uat_tx_1790769719777
                amount:
                  type: number
                  default: 1000
                  example: 1000
                data:
                  type: object
                  required:
                    - accountNumber
                    - phoneNumber
                  properties:
                    accountNumber:
                      type: string
                      default: '0219927013063'
                      example: '0219927013063'
                    phoneNumber:
                      type: string
                      default: '08012345678'
                      example: '08012345678'
            examples:
              electricityVend:
                summary: Electricity (AEDC - Code 300)
                value:
                  productCode: '300'
                  clientReference: uat_tx_elec_1790769719777
                  amount: 1000
                  data:
                    accountNumber: '0219927013063'
                    phoneNumber: '08012345678'
              mtnData:
                summary: MTN Data (110MB Daily - Code 111)
                value:
                  productCode: '111'
                  clientReference: uat_tx_mtn_1790769719777
                  amount: 100
                  data:
                    accountNumber: '08031234567'
                    phoneNumber: '08031234567'
              airtelData:
                summary: Airtel Data (75MB Daily - Code 2434)
                value:
                  productCode: '2434'
                  clientReference: uat_tx_airtel_1790769719777
                  amount: 75
                  data:
                    accountNumber: '08021234567'
                    phoneNumber: '08021234567'
              gloData:
                summary: Glo Data (2GB Special - Code 2649)
                value:
                  productCode: '2649'
                  clientReference: uat_tx_glo_1790769719777
                  amount: 500
                  data:
                    accountNumber: '08051234567'
                    phoneNumber: '08051234567'
      responses:
        '200':
          description: Transaction result and generated token
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: '00'
                  message:
                    type: string
                    example: Transaction successful
                  data:
                    type: object
                    properties:
                      transactionRef:
                        type: string
                        example: uat_tx_1790769719777
                      token:
                        type: string
                        example: 4819-2049-1829-4019-3382
                      units:
                        type: string
                        example: 34.5 kWh
                      amount:
                        type: number
                        example: 1000
                      status:
                        type: string
                        example: SUCCESS
              example:
                status: '00'
                message: Transaction successful
                data:
                  transactionRef: uat_tx_1790769719777
                  token: 4819-2049-1829-4019-3382
                  units: 34.5 kWh
                  amount: 1000
                  status: SUCCESS
components:
  securitySchemes:
    SecretKey:
      type: apiKey
      in: header
      name: secretKey
      description: SystemSpecs Demo / Live Secret Key
      x-default: sk_test_l/pQgOLgziOTzb+7pcUXVH2iX1MlpROsePDkNi/g/QmMs2c8P0DPr1vUP7xESiGG

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.