FIELD NAME | DESCRIPTION | NOTES | EXAMPLE
|
ID | Unique ID for the payment | |
|
TIMESTAMP | Date and time for the reading | Required
Time of payment in UTC timezone using ISO 8601 format yyyy-MM-dd'T'HH:mm:ss.SSS'Z' | 2021-05-16T14:16:01 |
PAYMENT_AMOUNT | Amount paid | Required | 5000 |
PAYMENT_CURRENCY | The currency of the transaction | Required | Naira |
TRANSACTION_TYPE | Possible values: FULL_PAYMENT, INSTALLMENT_PAYMENT, NON_CONTRACT_PAYMENT, DISCOUNT, REVERSAL, ENERGY_CREDIT | Required | INSTALLMENT_PAYMENT |
TRANSACTION_CHARGES | Charges associated with the transaction | Not Required | 1000 |
REFERENCE_ID | Payment reference ID | Not Required |
|
CUSTOMER_ID | The customer ID of the user of the device (SHS device or mini-grid meter). This may be required by the financing organization in order to verify the sale. | Required | 45987 |
METER_ID | | Required | 45987 |
|
CUSTOMER_NAME | Name of the customer | Required | John Does |
CUSTOMER_PHONE | Phone number of the user of the device | Not Required
Example : +234xxxxxx | +2344567890 |
CUSTOMER_CATEGORY | Category of the customer who uses the property applicable Required Description device. Dependent on the provider.
|
| Public, Prepaid, Residential, COmmercial, Business, etc |
FINANCING_ID | ID specific to the financing provider or program. | Not Requiried | FIN-ASSET-4567 |
AGENT_ID | The agent facilitating the transaction, such as a sales person's name | Not Requiried | Name of the Agent/company |
LATITUDE | Latitude of the location of the device | Not Requiried | 1.3,30.14 |
LONGITUDE | Longitude of the location of the device | Not Requiried | 1.3,30.14 |
UTILITY_ID | A unique ID for utility | Not Requiried |
|
FAILED_BATTERY_CAPACITY_COUNT | This field will track the number of instances where batteries fail to reach their capacity limit, a crucial metric for understanding payment and operational efficiency. | Not Requiried |
|
ACCOUNT_TYPE | This is the customer type | Not Requiried | Credit, debt, Public, Prepaid, Customer, Business, etc. |
STATUS | Payment status | Not Requiried | Assigned, processed, reversed, pending, error, MANUAL, etc. |
NOTES | Any other notes you want to add | Not Requiried | This is a payment |