👩Confirm Customer Details

Use this endpoint to confirm Customer Details, if they exist with Eskom.

post

Header parameters

AuthorizationstringRequired

API token for user authentication

Example: {"value":"Token tk-abc-1234-xyz"}

Body

application/json

objectOptional

Valid combinations for this request:

1. 'meter_no'
2. 'meter_card'
3. ['meter_no', 'supply_group_code', 'key_rev_no', 'tariff_index', 'token_tech', 'algo_tech']
4. 'name'
5. 'id_no'
6. 'account_no'
7. 'address'

and

and

Responses

200

customer confirmed successfully (with fallback to meter verification if customer not found)

application/json

Responseall of

and

400

invalid meter details

application/json

500

server error

application/json

post

/api/v1/meter/merchant-confirm-customer

HTTPcURLJavaScriptPython

POST /api/v1/meter/merchant-confirm-customer HTTP/1.1
Host: stage-api.digimali.co.za
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 318

{
  "algo_tech": "07",
  "key_rev_no": "1",
  "meter_no": "1234567890",
  "supply_group_code": "100600",
  "tariff_index": "07",
  "token_tech": "02",
  "meter_card": "600727123412341234===0716123456647",
  "account_no": "12345678901",
  "address": "11 Foo Lane, Johannesburg, 1700",
  "id_no": "123456787654321",
  "location_ref": "0987654321",
  "name": "Foo Bar"
}

{
  "id": "d9650f26-5037-4319-8c42-f27f36855855",
  "message": {
    "flow": "<flow_name>",
    "id_type": "5",
    "message_number": 183,
    "message_time": "20241116184733"
  },
  "customer_details": [
    {
      "customer_details": {
        "account_no": "12345678901",
        "address": "11 Foo Lane, Johannesburg, 1700",
        "can_vend": true,
        "days_since_last_purchase": 10,
        "has_fbe_due": false,
        "max_vend_config": {
          "amt": 100,
          "currency": "ZAR"
        },
        "min_vend_config": {
          "amt": 100,
          "currency": "ZAR"
        },
        "name": "Foo Bar"
      },
      "meter": {
        "algo_tech": "07",
        "key_rev_no": "1",
        "meter_no": "1234567890",
        "supply_group_code": "100600",
        "tariff_index": "07",
        "token_tech": "02"
      }
    }
  ],
  "supplier": "ravasvend"
}