Data Ingestion

Upload merchant's historical transactional information into Pezesha Credit Scoring Model.

Upload Transactions

POST {{BASE_URL}}/mfi/v1.1/data

This endpoint allows you to upload historical transactional record for a user/merchant so that they can get a credit score. A credit score is used to determine the user's loan limits. The MAX number of transactions allowed in the transactions array is 200 records. It is important that at least 6 months worth of data be uploaded when a user is registered so that they can be able to get a loan offer. This can be done in a background job once a user has been registered. The other_details section will be used to upload any additional information requested by the credit scoring team.

Headers

Name	Type	Description
Authentication*	string	Authentication token to track down who is emptying our stocks.

Request Body

Name	Type	Description
transactions.other_details	array	Key Value pair for additional fields requested by Credit Scoring Team
transactions.transaction_time	string	Time of transaction
transactions.face_amount	number	Amount
transactions.merchant_id	string	Merchant ID
transactions.transaction_id	string	Transaction ID
transactions*	array	An array containing multiple transaction records
channel*	string	Client Name provided by Pezesha during account setup (Capitalized)

200 Data has been uploaded successfully

{
   "status": 200,
   "response_code": 0,
   "error": false,
   "message": "Request processed successfully"
}

400 Could not process request.

{
   "status": 400,
   "response_code": 0,
   "error": true,
   "message": "Unable to process request"
}

Request Payload

{
   "channel": "Partner Name",
   "transactions":[
      {
         "transaction_id": "TR12356",
         "merchant_id": "MC12356",
         "face_amount": 400,
         "transaction_time": "2021-01-03 19:12:34",
         "other_details": [
            {
               "key": "location",
               "value": "Nairobi"
            },
            {
               "key": "category",
               "value": "OILS"
            }
         ]
      }
   ]
}