Skip to main content
POST
/
v1
/
lms
/
loans
/
{loanId}
/
submit-payment
Submit & verify an externally-collected repayment
curl --request POST \
  --url https://{baasHost}/api/v1/lms/loans/{loanId}/submit-payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "gatewayReference": "MPESA-ABC123XYZ",
  "amount": 35000,
  "fspId": "CLICKPESA",
  "note": "Collected by partner app"
}
'

Authorizations

​
Authorization
string
header
required

Bearer token from POST /generate-token. Expires ~1h; on 401, re-generate and retry once.

Path Parameters

​
loanId
string
required

Body

application/json
​
gatewayReference
string
required

Your gateway's transaction reference; idempotency key.

​
amount
number
required

Amount; must match the verified gateway amount.

​
fspId
string
Example:

"CLICKPESA"

​
note
string

Response

Verified and recorded