Monoova Australia; Added Credit Card Payments integration

Cost Centres

The webhook subscription has been updated to include Credit Card payment notifications. Click the Update button on the Credentials page of the Monoova service to subscribe to these notifications.

Bank Accounts

Admin, Bank Accounts On the Monoova page

• Check the "Is the Monova Account setup for Credit Cards?" checkbox.

On the Payment Methods page

• Add a new Payment Method, the Type must be Monoova_CreditCard and the Direction set to Incoming.

Client

Client, Tax & Banking page

• Add a New Client Banking Details item
• Select Monoova Card Token and the click Next
• Select the Payment Method that was created in the Bank Accounts
• Set the client email
• Click the + icon to add a new Card token
• Once completed click the Card Details button to fill in the credit card details

NOTE. The token generated to allow customers to fill in the credit card details has an expiry that is displayed on the Banking Details item. This expiry does not relate to the credit card.

NOTE. The client, if an individual, or person acting on behalf of, if a company, will need a First and Last Name to complete the registration of the card with Monoova.

Making a Payment

Account, Actions panel

• Make a Payment and select the Payment Method created for the Client.
• When the Payment is created a new Transaction will be created.
• The Transaction will be In Progress until it reaches a final status.

NOTE. The client, if an individual, or person acting on behalf of, if a company, will need a billing address to create a payment in Monoova.

Updating the Payment Status

The Payment status can be updated in the following ways:

• Pending Service Request wizard
• Clicking the Update Status button on the bank Transaction View
• Clicking the Update Status button on the summary page
• Receive the status automatically via the webhook

Payment Status

The Payment can go through various statuses before a final status is reached. The following are interim statuses:

• Initiated - A client session has been created but the payment has not been attempted
• Pending - The payment has been created but is not yet authorised
• Authorized - The payment has been authorised by the card issuer
• Pending Settlement - he payment has been authorised and is awaiting settlement. This may occur when funds are held
• Settlement In Progress - The payment is being loaded to your account

The following statuses are the final statuses for unsuccessful Payments:

• Failed - The payment failed to be authorised
• Declined - The payment was declined by the card issuer
• Cancelled - The payment authorisation has been cancelled

The following status is the final status for a fully settled Payment:

• Settlement Complete - The payment has been loaded to your account

Primer SDK Card Entry

Credit Card details can be entered by clicking the Card Details button on the Client Banking Details form, once the Monoova Card Token has been generated. This will display an HTML Viewer, and provide a method to input the card details.

The interface used to achieve this is Primer Checkout and has been specified by Monoova. For more information, see this Blog.

Note: This will not store the card details in the finPOWER Connect database - this merely links the token, and the card at Monoova.

Alternatively, if you wish to display the HTML page on a Portal or HTML Widget so the customer can enter their own card details directly, you can generate the required HTML by using the function:

finBL.BankingFunctions.GetMonoovaCreditCardHtml(token As String,
                                           ByRef html As String,
                                  Optional logoBase64 As String = "",
                                  Optional message As String = "") As Boolean)

token - This is the token generated on the Client Banking Details.

html - This is the HTML generated by the function.

logoBase64 - Optionally, a logo can be specified to display in the HTML. If omitted, the finPOWER Connect logo will be used.

message - Optionally, a message can be specified to display in the HTML. If omitted, "Linking Credit Card details to Monoova Payment Token ending in XXXXXX" will be displayed (where XXXXXX is the last 6 characters of the token).

The following built-in summary pages have been updated:

• SummaryPage2_BankingInterfaceSummary_Monoova
• Version: 1.03 (19/11/2025)

The following standard Summary Page blocks have been updated:

• Account_BankingDetailsSummary
• Version: 1.20 (20/11/2025)

• BankTransactionView_PaymentDetails
• Version: 2.11 (20/11/2025)

The following HTML Widgets have been updated:

• HtmlWidget_ClientBankAccount
• Version: 1.11 (25/11/2025)

• HtmlWidget_BankAccountEdit
• Version: 1.02 (25/11/2025)