1. Transaction Workflow

RealPay Instant EFT allows Microfinance Lending Entities (MLEs) to collect loan payments instantly via a secure digital link sent directly to the client. The client authorizes the payment using their own online banking platform.

[MLE creates Receipt] --> [Client receives SMS] --> [Client Authenticates via Bank]
                                                               ¦
[Receipt Processed]   <-- [System Pulls Status] <-- [RealPay Holds Response]

The Transaction Flow

• Initiation: The MLE user creates a receipt of type Instant EFT within the system.
• Notification: An SMS containing a secure payment link is automatically dispatched to the client's mobile number.
• Authorization: The client clicks the link and authenticates the transaction using their bank's online banking portal.
• Status Retrieval: RealPay does not push transaction statuses automatically. The system must query ("pull") the status from RealPay.
• Completion: Once a successful authentication response is retrieved, the receipt is formally recorded in the system.

2. System Configurations

Before processing Instant EFT transactions, the following configurations must be completed across MaxAdmin and MaxMoney.

2.1 MaxAdmin Configurations (Botswana Specific)

• Event Attributes: Enable Instant EFT Receipt as an Event Attribute.
• Security Resources: Enable Receipt - Instant EFT Receipt as a Security Resource.
• SMS Settings: Ensure MaxSMS is actively enabled for the MLE.

2.2 MaxMoney System Setup

• MaxSMS General Setup: Ensure the Instant EFT module toggle is turned ON .
• SMS Logging & Allocation: * Instant EFT SMS notifications must log correctly under the SMS Logs and the MaxSMS Detail Report .
  • Outbound SMSes will be deducted from the MLE’s allocated SMS balance.
• Financial Events: Create a new Financial Event for Instant EFT and map it to the Cashbox .

2.3 MaxCollect - CSP Settings

Configure the Payment Service Provider (CSP) parameters exactly as outlined below:

• MaxCollect - CSP Users :
  • User Details: Input credentials from RealPay
  • CSP: Real Pay 2024
• MaxCollect - CSPs :
  • CSP: Real Pay 2024
  • Payback Type: Instant EFT Receipt
  • Real Pay Product Code: Instant EFT(Botswana)
  • Merchant Number: (Beneficiary User from RealPay)
  • Batch User: Input credentials from RealPay

3. User Operations in MaxMoney

3.1 Processing a Receipt

• Loan Eligibility: A loan can have any payback type assigned at creation; it does not need to be explicitly created as an "Instant EFT" payback type.
• Initiating the Payment: Process the transaction using the standard Cash Receipt workflow.
• Step 1 (Receipt Page 1): Select Instant EFT from the Receipt Event dropdown list.
• Step 2 (Receipt Page 2): * Enter the payment amount .
• The standard Finish button will dynamically change to Collect Now . Click Collect Now.

3.2 Managing and Checking Transaction Status

Upon clicking Collect Now, you will be redirected to the Instant EFT Status page.

• Pending Status: The transaction status will reflect as Future until the client either authorizes or cancels the payment.
• Manual Query: Click the Check Status button to manually poll RealPay for an updated status.

[!NOTE]

RealPay status updates are not instantaneous. If a client approves a transaction, it may take 1 to 2 minutes for the system to reflect the update. The status will show as Future during this propagation delay.

• Receipt Recording: The system will not write the receipt to the database while the status is pending. The receipt is recorded only after a Successful status is confirmed.

3.3 Alternative Monitoring (Instant EFT Log)

If an operator needs to navigate away from the processing page, they can monitor transactions asynchronously:

• Navigate to Client Search > Instant EFT Log .
• This log displays historical transaction statuses and allows users to manually trigger a status check on pending records.

3.4 Automated Background Processing

A scheduled background process (Celery task) runs twice daily at 07:30 and 15:30 .

• This task scans for any transactions from the last 3 days that are still marked as Future in MaxMoney.
• If RealPay confirms they have been successfully authenticated in the interim, the background task automatically processes the receipt and updates the status to Successful .

4. Verification Protocols

Take note of the following scenarios:

• Instruction Cancellation: If an Instant EFT is initiated on an existing loan that possesses active payment instructions (PINs) via RealPay or another CSP, ensure those existing PINs are automatically cancelled at that CSP once the loan is settled by the Instant EFT.