Get Remita Payment History

Overview

Returns the repayment history for a specific loan from the Remita platform. This query retrieves all salary deduction payments that have been collected against the loan's mandate.

Command Details

• Command: GetRemitaPaymentHistoryQuery
• Type: Query

API Endpoint

POST /api/bpm/cmd

Request Structure

Field	Type	Required	Description
id	long	No	ID of the loan request
authorisationCode	string	No	Remita authorisation code
customerId	string	No	Remita customer identifier
mandateRef	string	No	Mandate reference number

Try It Out

POST/api/bpm/cmdGetRemitaPaymentHistoryQuery

Base URL

Bearer Token

Request Body

{ "cmd": "GetRemitaPaymentHistoryQuery", "data": { "id": 5001, "customerId": "CUST-001234" } }

Response Structure

{
  "success": true,
  "data": {
    "id": 5001,
    "mandateReference": "REM-MND-2026-0042",
    "totalRepaid": 93000.00,
    "outstandingBalance": 4907000.00,
    "payments": [
      {
        "paymentDate": "2026-03-01",
        "amount": 500000.00,
        "status": "Successful",
        "remitaReference": "REM-PAY-2026-03-001"
      },
      {
        "paymentDate": "2026-02-01",
        "amount": 500000.00,
        "status": "Successful",
        "remitaReference": "REM-PAY-2026-02-001"
      }
    ],
    "paymentCount": 2
  },
  "message": "Payment history retrieved successfully"
}

Related Operations

• Sync Payment History — Sync Remita repayments to local DB
• Retrieve Loan by ID — View loan request details
• Get Salary History — View borrower salary history