⚡Vend Trial Token

Use this endpoint to vend a Trial Electricity Token.

post

Header parameters

AuthorizationstringRequired

API token for user authentication

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

Body

application/json

algo_techstringOptional

Algorithm technology

Example: 07

amtnumber · floatRequired

Amount to vend

Example: 1460.45

call_back_urlstringRequired

Callback URL for payment completion

Example: https://skhokho.io

channelstringRequired

Users vending channel code

Example: ios

key_rev_nostringOptional

Key revision number

Example: 2

meter_nostringRequired

Meter number

Example: 12345678912

paystack_flowbooleanOptional

Paystack flow

Example: true

supply_group_codestringOptional

Supply group code

Example: 102059

tariff_indexstringOptional

Tariff index

Example: 01

token_techstringOptional

Token technology

Example: 02

Responses

200

Authorization URL generated successfully

application/json

aggregation_idstringOptionalExample: 0ea72d93-0158-4eb3-b25d-879f1e1f83dd

amtstring · nullableOptionalExample: 200.00

categorystringOptionalExample: reg

chargesobject[]OptionalExample: []

client_idstringOptionalExample: 6004708001981

display_headerstringOptionalExample: CREDIT VEND - TAX INVOICE

idstringOptionalExample: b3e84bcc-7b32-47f7-b919-696fd076ad6a

old_meter_nostringOptionalExample: 12345678901

payment_urlstringOptionalExample: https://checkout.paystack.com/46ej9uwob4udike

resp_date_timestring · date-timeOptionalExample: 2024-10-17 03:00:31

statusstringOptionalExample: done

supplierstringOptional

Supplier name

Example: ravasvend

terminal_idstringOptionalExample: 0000000000001

unitsinteger · nullableOptional

vend_typeintegerOptionalExample: 2

400

Invalid input

application/json

500

Server error

application/json

post

/api/v1/meter/trial-vend

HTTPcURLJavaScriptPython

POST /api/v1/meter/trial-vend HTTP/1.1
Host: stage-api.digimali.co.za
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 215

{
  "algo_tech": "07",
  "amt": 1460.45,
  "call_back_url": "https://skhokho.io",
  "channel": "ios",
  "key_rev_no": "2",
  "meter_no": "12345678912",
  "paystack_flow": true,
  "supply_group_code": "102059",
  "tariff_index": "01",
  "token_tech": "02"
}

{
  "account": {
    "account_number": "0987654321"
  },
  "aggregation_id": "0ea72d93-0158-4eb3-b25d-879f1e1f83dd",
  "amt": "200.00",
  "category": "reg",
  "charges": [],
  "client_id": "6004708001981",
  "display_header": "CREDIT VEND - TAX INVOICE",
  "id": "b3e84bcc-7b32-47f7-b919-696fd076ad6a",
  "meter": {
    "algo_tech": "07",
    "key_rev_no": "1",
    "meter_no": "1234567890",
    "supply_group_code": "100600",
    "tariff_index": "07",
    "token_tech": "02"
  },
  "old_meter_no": "12345678901",
  "payment_url": "https://checkout.paystack.com/46ej9uwob4udike",
  "resp_date_time": "2024-10-17 03:00:31",
  "status": "done",
  "supplier": "ravasvend",
  "terminal_id": "0000000000001",
  "tokens": [
    {
      "amt": "200.00",
      "created": "2024-10-17T17:00:31.213232+02:00",
      "currency": "ZAR",
      "desc": "Normal Sale",
      "receipt_no": "0987564321",
      "tariff_desc": "52.17 c/kWh",
      "tariff_name": "HomeLight 1 (60A)",
      "taxes": [
        {
          "amt": "24.56",
          "currency": "ZAR",
          "rate": "14.00"
        }
      ],
      "type": 1,
      "unit_type": "kWh",
      "units": "383.39",
      "value": "56493153725450313471",
      "vat_no": "9876543210"
    }
  ],
  "units": null,
  "utility": {
    "address": "Foo Road",
    "name": "Eskom",
    "tax_ref": "1234567890"
  },
  "vend_type": 2,
  "vendor": {
    "address": "Foo Road",
    "name": "Eskom"
  }
}