Paym8 Payment Integration

MaxCollect Module

This section provides a comprehensive guide to setting up and using the MaxCollect module for Paym8 payment collections, available for Namibia.

Overview

Paym8 offers a robust payment collection solution seamlessly integrated with MAXMONEY. This integration supports various payment streams tailored to specific country requirements.

MAXMONEY Setup

Before commencing with Paym8 payment collections, a series of one-off setups must be completed in MAXMONEY.

Ledger Setup

Paym8 Merchant Account

You must establish a dedicated ledger to record loan payments collected via the Paym8 integration.

• Navigate to: Setup ? Accounting ? Financial Ledgers.

• Configuration:

  • The control account type = Bank Sub-Ledger

  • Financial Report = Statement of Financial Position

  • Display Financial Category on Report = Bank Control Account

  • VAT Type = None

Event Setup

Financial events are crucial for correctly categorizing incoming payments based on their type and country.

• Navigate to: Setup ? Accounting ? Financial Events.

Payment Streams

Paym8 supports various payment stream types, each with a specific MAXMONEY Event Attribute.

• Real Pay Online Card Based Transaction

  • Description: A card-based payment channel where the CVV is only required for the initial authorization transaction, not for recurring transactions. Merchants do not need to capture or store card data.

  • Used In: Botswana.

  • MAXMONEY Event Attribute: Paym8 Card Payment Receipt

• EnDO (Enhanced One Day Debit Order)

  • Description: A debit order solution providing automatic tracking of the account holder's account for insufficient funds at the time of collection. Used for priority account-based electronic collections with tracking.

  • Used In: Namibia.

  • MAXMONEY Event Attribute: EnDO Receipt

• Same Day Debit Order (SDDO)

  • Description: An EFT (Electronic Funds Transfer) Debit Order where payment data must be provided to the bank for processing on the business day of the action date.

  • Used In: South Africa (for regular, account-based electronic collections) and Botswana (for account-based transactions).

  • MAXMONEY Event Attribute: EFT Receipt

• Two Day Debit Order (TDDO)

  • Description: An EFT Debit Order where payment data must be provided to the bank a minimum of two business days prior to the action date.

  • Used In: RSA for SASSA Grindrod accounts.

  • MAXMONEY Event Attribute: Two Day EFT Receipt

Receipt Event

Set up a financial event for each receipt type to ensure proper accounting.

• Navigate to: Setup ? Accounting ? Financial event.

• Action:

  • Debit the Paym8 Control Account.

  • Credit the Debtors Control Account.

• Event Attribute (Based on Country/Type):

  • Namibia: EnDO Receipt

  • South Africa: DebiCheck Receipt, EFT Receipt, Two Day EFT Receipt

  • Botswana: Paym8 Card Based Receipt, RTDO Receipt, EFT Receipt

• Ensure VAT Applicable = off.

Document Setup

A written mandate is required for specific receipt types.

• Mandate Requirement: Required for EFT Receipt Type and EnDO Receipt Type.

• Navigate to: Setups ? Documents.

• Complete the following information:

  • Type = (The Receipt Type)

  • Language: English

  • CSP: Paym8

  • Enabled: Selected

  • Use Master Document = unselected

User Access (Resources)

MaxMoney users require specific security access to manage loans, distributions, and repayments through the Paym8 integration.

• Navigate to: Setups ? Security ? Roles ? Edit Role.

• Enable the following resources:

  CLIENT

  • Client Tracking Days

  • Payback Detail

  EMPLOYER

  • Employer Tracking Days

  HTML Printing

  • Print & Reprint a Payback Instruction

  LOAN

  • Create Payback Instruction

  • Loan Tracking Days

  • MaxCollect Parameters

  • Payback Type

  MAXCOLLECT

  • Manage Other Branch Payback Instructions

  • Manage Payback Instructions

  • Manage Payout Instructions

  • View Payback Instructions

  • View Payout Instructions

  PROCESSING

  • Processing: Client Change Payback Type Batch

  • Processing: MaxCollect: Reschedule of Payback Instruction Instalment Arrears

  • Processing: MaxCollect: Resubmission of Instalments

  REPORT

  • CSP Setup Log Report

  • CSP User Setup Log Report

  • Declined Payback History Report

  • MaxCollect Loan Audit Report

  • MaxCollect Loan Instalment Report

  • Payback Type Performance Report

  SETUP

  • MaxCollect CSPs

  • MaxCollect CSP User Setup

  • MaxCollect General

  • MaxCollect Paym8 Bank Setup

  • MaxCollect Tracking

  • Payback Types Disabled

MAXCOLLECT (Paym8 Specific Setups)

Configure the Paym8 integration parameters within the MaxCollect setup menu.

• Navigate to: MAXMONEY ? Setup ? MaxCollect.

Tracking

• Navigate to: Setups ? MaxCollect ? Tracking.

• Note: This setting is not applicable for Paym8.

CSP User

Set up a CSP user for each user who will activate Paym8 Loans and create Payback instructions. (Note: The Lewies group uses a single super user.)

• Navigate to: Setups ? MaxCollect ? CSP User.

• Credentials: The CSP Username, password, and MerchantNo are supplied by Paym8. There are two merchant numbers: a CSP USER merchant number (Paym8 specific) and a CSP Merchant Number (the Merchant Id at Paym8). Enter the former (CSP USER merchant number) here.

CSP (Payback Methods)

Configure a CSP setup for each relevant payback type. Be careful not to duplicate setups.

• Navigate to: Setups ? MaxCollect ? CSPs.

• Action: Perform a CSP setup for each of the following payback types:

  • Namibia: EnDO Receipt

  • South Africa: DebiCheck, EFT, Two Day EFT

  • Botswana: Paym8 Card Based

• Merchant ID: Paym8 provides a CSP USER merchant no. (Paym8 specific) and a CSP Merchant No. (the Merchant Id at Paym8). Enter the latter (CSP Merchant No.) here.

• Batch User: If you encounter the error: “! Select a valid choice. That choice is not one of the available choices,” you must select "None" (the option with lines --------).

General MAXCOLLECT

• Navigate to: Setups ? MaxCollect ? General.

• Email Logs: If you do not wish to receive email logs, do not tick “E-mail Logs Enable”.

General Client Setup

Set the standard initial payback type for clients.

• Navigate to: Setups ? Client ? General.

• Set the standard initial payback type:

  • Namibia: EnDO Receipt

  • South Africa: DebiCheck Receipt, EFT Receipt, Two Day EFT Receipt

  • Botswana: Paym8 Card Based Receipt, RTDO Receipt, EFT Receipt

Use in MAXMONEY

This section describes how to configure and manage Paym8-related settings for clients and during the loan process within MaxMoney.

Client

You can view and match client information on the CSP (Paym8) portal.

General Client Information

• Navigate to: Client Administration ? Search for a Client ? Edit Client.

• ID Number: Must be numeric.

Client Bank Information

• Navigate to: Client Administration ? Search for a Client ? Edit Client ? Banking.

• Note: Only certain banks are allowed. Confirm with the CSP (Paym8).

Client Payback Information

• Navigate to: Client Administration ? Search for a Client ? Edit Client ? Payback Information.

• Payback Type (based on country):

  • Namibia: EnDO Receipt

  • South Africa: DebiCheck Receipt, EFT Receipt, Two Day EFT Receipt

  • Botswana: Paym8 Card Based Receipt, RTDO Receipt, EFT Receipt

• Set Preferred CSP = Paym8.

• Set Preferred CSP Setup = Paym8 EnDO (for Namibia, or applicable setup for other regions).

Client Cellphone Number

• Navigate to: Client Administration ? Search for a Client ? Edit Client ? Address.

• Requirement: The cell phone number is mandatory. If not supplied, attempting to create the loan will result in the error: "The Contract Could Not Be Created. A Contact Number Is Required But None Has Been Specified For This Client".

Existing Loan

You can create a new payback instruction on an existing loan.

• Navigate to: Client Administration ? Search for a Client ? Loans ? Create Payback Instruction.

• Verification: Ensure the correct payback type and CSP are selected.

Cancel a Loan

• Navigate to: Client Administration ? Search for a Client ? Loans ? Edit Loan.

• Action: Change the status of the loan.

• Reason: Provide a reason for the loan cancellation.

• Finalize: Save and Close.

Reschedule Instalments on a Loan

• Navigate to: Client Administration ? Search for a Client ? Loans ? Edit Loan ? Loan Instalments ? Reschedule.

• Start Date: The start date should be the first day of the following month. MAXMONEY will automatically calculate the correct instalment day.

Receive a Manual Payment on a Loan

• Navigate to: Client Administration ? Search for a Client ? Loans ? Receipt.

• Effective Date: Select the actual date the payment was received.

• Transaction Date: This should typically be the same as the Effective Date.

• Amount: Enter the amount of the payment received.

Payback Instruction

• View: View the payback instruction under Client Administration ? Search for a Client ? Loans ? Payback Instruction.