1. Home
  2. Interswitch lending Service
  3. Interswitch Lending Service (Providers)
  4. Credit Customer

Credit Customer

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 nameData typeMax lengthRequiredDescription
1customerIdString50trueThe Email or Mobile Number of the User to the credited.
2loanIdString50trueThe Id of the loan for which this credit request is made.
trueThe Amount to be credited to the user’s account. (This is in lower denomination KOBO)
4providerCodeString50trueThe Code of the provider from which this request is coming from.
5currencyCodeNumeric String3falseISO 4217 standard currency code. Default to 566
6transactionIdNumeric String
falseThe Identifier for this transaction that can be used for Requery in later time.
falseThe quickteller terminalId to be used.
8loanReferenceIdString50trueA 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.


POST /loans/{ loanId }/fund


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",

Response Message  field description

Field#Field nameData typeMax lengthRequiredDescription
1responseCodeNumeric String5trueThe code representing the status of the processing of this request
2responseMessageString255trueThe description of the responseCode.
3transactionRefString50trueThe Quickteller Transaction Reference for the transfer request.
4transactionIdNumeric 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."

Was this article helpful to you? Yes 1 No

How can we help?