Skip to main content

Create Remita Loan Request

Overview​

Creates a new Remita loan request with borrower and loan details. The loan request is created in Created status and must be submitted for approval before it can proceed through the lifecycle.

Command Details​

  • Command: CreateRemitaLoanRequestCommand
  • Type: Command

API Endpoint​

POST /api/bpm/cmd

Request Structure​

FieldTypeRequiredDescription
cifstringYesCustomer Information File identifier
accountNumberstringYesBorrower's bank account number
accountNamestringNoName on the account
bvnstringYesBank Verification Number
phoneNumberstringNoBorrower's phone number
emailstringNoBorrower's email address
companyNamestringNoBorrower's employer name
employerRegistrationNumberstringNoEmployer registration number with Remita
loanAmountdecimalYesRequested loan amount
collectionAmountdecimalYesMonthly salary deduction amount
tenureintYesLoan tenure in months
interestRatedecimalNoAnnual interest rate (default: 0)
disbursementChannelintNoDisbursement channel code (default: 0)
loanAccountstringNoAccount to receive disbursed funds
organisationIdlongYesOrganisation identifier
tagstringNoLoan category tag
bankCodestringNoCBN bank code
remitaCustomerIdstringNoRemita customer identifier
authorisationCodestringNoRemita authorisation code

Try It Out​

POST/api/bpm/cmdCreateRemitaLoanRequestCommand
Request Body

Response Structure​

{
  "success": true,
  "data": {
    "id": 5001,
    "cif": "CIF-001234",
    "accountNumber": "0012345678",
    "loanAmount": 5000000.00,
    "tenure": 12,
    "status": "Created",
    "createdAt": "2026-03-09T10:30:00Z"
  },
  "message": "Loan request created successfully"
}