Amber
This section details the necessary setups
and procedures within MAXMONEY to enable and manage loan payouts through the
Amber integration via the MaxCollect Module.
For a visual
representation, view the
infographic
Amber Payout Integration
MaxCollect Module
Section
Description
Documentation
Setups
Setup configurations
for the Amber integration
Once off Setups
Client and Employer
configuration
Client and Employer
configurations for the Amber integration
Employer and
Client
New Loan
This section outlines
the standard workflow for creating a new loan
Payouts and New
Loan
Before integrating with Amber for payouts, ensure the following one-off configurations are completed in MAXMONEY.
To grant users access to manage and view payout instructions, enable the following resources in their roles:
Navigate to: Setups -
Security - Roles - Edit.
Enable the following resources:
Manage
Payout Instructions
View Payout
Instructions
A financial ledger must be set up for the Amber merchant account to track payout transactions.
Video tutorial: For a visual guide on setting up the Financial
Ledger & Event, watch the video:
Setup the Financial Ledger:
Navigate to: Setups - Accounting - Financial Ledgers:
6800-000x (replace x with your
specific ledger number).
Complete the fields:
Description = Amber Merchant Bank Account
Control Account Type =
Bank Sub-ledger
Financial Report =
Statement of Financial Position
Display in Financial Category =
Bank Control Account
VAT Type =
None
Merchant CSP =
Amber
Merchant Account Number - Obtain this from Amber.
Merchant Branch Code =
410600
Merchant Account Type =
Savings
Merchant Reference - Obtain the GID (Global Identifier) from
Amber.
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 =
Amber Pay-out
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
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 the Save button.
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
A CSP (Collection Service Provider) User must be set up to enable communication with Amber.
Video tutorial: For a visual guide on setting up the CSP User, watch
the video:
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.
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.
This section details the necessary settings related to employers and clients for Amber payouts.
No specific employer setups are required for Amber Payout Integration.
The client's banking information for payouts must be accurately configured.
Complete Client's Payout Banking Information: It is essential that this is a valid account.
Navigate to: Client
Administration > Search for
a Client > Edit Client > Banking > Add a New Bank Account.
Video tutorial: For a visual guide on client bank account settings,
watch the video:
This setup is for enabling payouts via Amber Cash Access Cards.
Video tutorial: For a visual guide on setting up the cash access
card, watch the video:
Navigate to: Client Administration - Search for a Client -
Edit Client.
General Tab:
Ensure the client has a South African ID.
Banking Tab:
Click "Add a New Wallet".
Complete the fields:
Enabled = Tick this checkbox.
Preferred Choice = Tick this checkbox.
CSP =
Amber
Access
Method = Cash Access Card
BIN Number = Enter the first 6 digits on the card.
Sequence Number = Enter the last 4 digits on the
card.
This section covers the process of creating and managing payout instructions for loans using Amber.
Video tutorial: For a visual guide on performing the payout, watch
the video:
Navigate to: MAXMONEY > Client Administration > Search for a
Client > Highlight the client and click the "New Loan" button.
Create the loan as usual.
On the summary screen, select Amber Pay-out as the
payment to client method.
Verification: Log in to the Amber portal to view the payout on the merchant account.
View Payout Instruction on the Loan:
Navigate to: MAXMONEY > Client Administration > Search for a
Client > Highlight the client and click the "Loans" button.
Select "Payout Instruction".
You can refund a previously executed payout instruction.
Video tutorial: For a visual guide on refunding the payout, watch
the video:
Navigate to: MAXMONEY > Client Administration > Search for a
Client > (Highlight the client) click on the "Loans" button.
Select "Payout Instruction".
Click "Refund Payout Instruction".
Confirmation:
Set Confirm Purchase Refund = Yes.
Click the "Refund" button.
Result:
The status of the payout instruction will change to “Refund
Completed”.
The payout on the merchant account will be reversed.
Note: No accounting changes will occur in MAXMONEY for the refund.
Watch another video on YouTube for more details: