Retrieve Loan Transaction

Returns one transaction of the loan.

The customer is named with exactly one of clientId or nuban (the number of one of the customer's savings accounts). The loan must belong to that customer, otherwise the request is refused with 403.

Path Parameters

Field Name	Type	Required	Description
`loanAccountNo`	string	TRUE	The loan's account number, as returned when the loan was created.
`transactionId`	integer	TRUE	Id of the loan transaction.

Query Parameters

Field Name	Type	Required	Description
`clientId`	integer	FALSE	The customer's client id. Send exactly one of `clientId` or `nuban`.
`nuban`	string	FALSE	NUBAN of one of the customer's savings accounts. Send exactly one of `clientId` or `nuban`.

Response Body

Field Name	Type	Description
`id`	integer	Transaction id.
`loanAccountNo`	string	Account number of the loan.
`type`	object	Transaction type.
`date`	array	Date as [year, month, day].
`amount`	number	Amount of the transaction.
`principalPortion`	number	Principal part.
`interestPortion`	number	Interest part.
`outstandingLoanBalance`	number	Balance after the transaction.

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: {{tpGatewayHostUrl}}/security/authenticate

Responses

🟢200The transaction

application/json

The transaction

Bodyapplication/json

Example

{
  "id": 31,
  "loanAccountNo": "000000059",
  "type": {
    "id": 2,
    "code": "loanTransactionType.repayment",
    "value": "Repayment"
  },
  "date": [
    2026,
    11,
    6
  ],
  "amount": 9000,
  "principalPortion": 8000,
  "interestPortion": 1000,
  "feeChargesPortion": 0,
  "penaltyChargesPortion": 0,
  "outstandingLoanBalance": 41000
}

🟠400The request could not be processed

🟠401The merchant's account has not been granted this operation,

🟠403The loan is not the customer's, or your API user does not ha

🟠404Not found

🔴500The request could not be completed

Path Parameters

Query Parameters

Response Body

Request

Request Code Samples

Responses

Retrieve Loan Transaction

Path Parameters#

Query Parameters#

Response Body#

Request

Request Code Samples

Responses

Path Parameters

Query Parameters

Response Body