Once Off Setups

2. MAXMONEY Setups

Before integrating with Amber for payouts, ensure the following one-off configurations are completed in MAXMONEY.

2.1 Resources

To grant users access to manage and view payout instructions, enable the following resources in their roles:


2.2 Ledger

A financial ledger must be set up for the Amber merchant account to track payout transactions.


2.3 Event

A financial event must be configured specifically for Amber payouts.

  • Navigate to :Setups - Accounting - Financial Events.

  • Complete the fields :

    • Description = Amber Pay-out

    • Transaction Description

      • For Cash Access : Amber Cash Access Pay-out

      • For Internal Transfer : Amber Internal Transfer

      • For RTC External Transfers : Amber RTC External Transfer 

    • Dr = 1000-0000 Capital Out (Debit: Capital Out)

    • Cr = 6800-000x Amber Merchant Bank Account (Credit: Your Amber Merchant Bank Account ledger)

    • Event Attribute = Payment to Client Bank Account


2.4 Cash Box

Link the Amber payout event to the relevant cash box(es) to ensure that cashiers have access to this payout type.

  • Navigate to:Setups - Branches - Cash Boxes - Edit Cash Boxes - Financial event Tab .

  • Action: Select the relevant receipt and payout events (events are in alpha-numerical order by description) and click theSave button.


2.5 MaxCollect General

Configure the general settings for MaxCollect to align with the Amber integration.

  • Navigate to:Setups - MaxCollect - General.

  • Complete the fields:

    • Mode = Basic

    • Preferred CSP = SureSystems


2.6 CSP User

A CSP (Collection Service Provider) User must be set up to enable communication with Amber.

2.6.1 CSP User (Legacy)

This section applies to older or legacy Amber integration methods.

  • Navigate to: Setups - MaxCollect - CSP Users.

  • Complete the fields:

    • User = The MaxMoney user who will be logging in.

    • Branch = The branch where the user works.

    • CSP Username - Obtain this from Amber.

    • Password - Obtain this from Amber.

    • CSP = Amber

    • Enabled = Tick this checkbox.

    • CSP Super User = Do not tick this checkbox.

2.6.2 CSP User (RTC - Real-Time Communications)

This section applies to newer Amber integration methods utilizing REST APIs.

  • Navigate to: Setups - MaxCollect - CSP Users.

  • Complete the fields:

    • User = The MaxMoney user who will be logging in.

    • Branch = The branch where the user works.

    • CSP Username - Obtain this from Amber.

    • Password - Obtain this from Amber.

    • CSP = Amber

    • Enabled = Tick this checkbox.

    • CSP Super User = Do not tick this checkbox.

    • Use Amber REST = Tick this checkbox.


MAXMONEY Developed by MYCOMAX MICROFINANCE SOLUTIONS. Novamesh 18/06/2026