This endpoint is provisioned for providers to use when they want to credit the user’s account for the loan amount. Service will fire a fund transfer advice request to Quickteller with the configured details of the Provider.

Request Message description

Field#	Field name	Data type	Max length	Required	Description
1	customerId	String	50	true	The Email or Mobile Number of the User to the credited.
2	loanId	String	50	true	The Id of the loan for which this credit request is made.
3	amount	Long		true	The Amount to be credited to the user’s account. (This is in lower denomination KOBO)
4	providerCode	String	50	true	The Code of the provider from which this request is coming from.
5	currencyCode	Numeric String	3	false	ISO 4217 standard currency code. Default to 566
6	transactionId	Numeric String		false	The Identifier for this transaction that can be used for Requery in later time.
7	qtTerminalId	String		false	The quickteller terminalId to be used.
8	loanReferenceId	String	50	true	A unique identifier assigned to the loan from the Lending Service. It should be the same loan reference id that was sent to the provider in the AcceptOffer request body.

Endpoint

POST /loans/{ loanId }/fund

Headers

Authorization: Bearer {{token}}

Sample Request

{
"customerId": "2348123456789",
"loanId": "01238797",
"amount": 1250000, // One thousand, Two hundred and Fifty Naira only.
"providerCode": "ABCREDIT",
"currencyCode": "566",
"transactionId": "198988747587875",
"qtTerminalId" : "3PBL",
"loanReferenceId":"ABC1234568903456785937382894"
}

Response Message  field description

Field#	Field name	Data type	Max length	Required	Description
1	responseCode	Numeric String	5	true	The code representing the status of the processing of this request
2	responseMessage	String	255	true	The description of the responseCode.
3	transactionRef	String	50	true	The Quickteller Transaction Reference for the transfer request.
4	transactionId	Numeric String			The Identifier for this transaction. This will be requery of this transaction.

Sample Response (success)

{
"responseCode" : "00",
"responseMessage" : "Transaction Successful",
"transactionRef" : "UBN|WEB|ILS|20170501091282|01238797",
"transactionId": "198988747587875"
}

Sample Response (failure)

{
"responseCode" : "96",
"responseMessage" : "Issuer or Switch Inoperative."
}