> ## 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.

# Validate Customer Meter / Account

> Verify customer meter number, account number, or smartcard ID before initiating payment.

Perform real-time customer KYC and meter status validation. This endpoint verifies that the meter or account is active, returns the registered customer name, minimum/maximum vend amount, and account type (Prepaid / Postpaid).

### Request Payload

| Field | Type | Required | Description |
| :- | :- | :- | :- |
| `productCode` | `string` | **Yes** | The biller or product code (e.g. `300` for AEDC, `102` for IKEDC, `101` for EKEDC). |
| `accountNumber` | `string` | **Yes** | The customer's meter number, account number, or smartcard number. |

### Sandbox Test Meters

| DisCo | Product Code | Meter Number | Expected Name |
| :- | :- | :- | :- |
| **AEDC** | `300` | `0219927013063` | Ade |
| **IKEDC** | `102` | `45702044269` | Adene Jonah |
| **EKEDC** | `101` | `12345678910` | Demo Customer |

### Successful Response

```json theme={null}
{
  "message": "Success",
  "status": "00",
  "data": {
    "name": "Ade",
    "accountNumber": "0219927013063",
    "productCode": "300",
    "minAmount": 500,
    "maxAmount": 50000,
    "address": "Abuja, FCT"
  }
}
```


## OpenAPI

````yaml remita_openapi.json POST /vending/validate
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/validate:
    post:
      summary: Validate Meter / Account
      description: >-
        Verify customer meter number or account number before initiating a
        payment.
      operationId: validateCustomer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - productCode
                - accountNumber
              properties:
                productCode:
                  type: string
                  default: '300'
                  example: '300'
                accountNumber:
                  type: string
                  default: '0219927013063'
                  example: '0219927013063'
      responses:
        '200':
          description: Customer verification result
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: '00'
                  message:
                    type: string
                    example: Customer validation successful
                  data:
                    type: object
                    properties:
                      customerName:
                        type: string
                        example: ADEWALE AYODEJI PETERS
                      accountNumber:
                        type: string
                        example: '0219927013063'
                      address:
                        type: string
                        example: 14 ADEOLA ODEKU STREET, VI, LAGOS
                      tariff:
                        type: string
                        example: A1-R2
              example:
                status: '00'
                message: Customer validation successful
                data:
                  customerName: ADEWALE AYODEJI PETERS
                  accountNumber: '0219927013063'
                  address: 14 ADEOLA ODEKU STREET, VI, LAGOS
                  tariff: A1-R2
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.