QSOP + Xero OAUTH2

Integration Guide

Here is your step-by-step guide to get you started.

With Xero and QuickFee integrated, you can save time and take care of all your accounting needs in one place. Get setup now and start winning more business and reducing debtor days.

Step 1

In Red Planet Odyssey Creditor Broker System, create a new entry for Type ‘Xero 2’. Fill in the details according to the Xero App settings as per below

Enable drilldown on Payment Portal, Validate Invoice on Payment Portal and Populate Client Detail on Payment Portal will still the same as previous Xero functionality.
The redirect URI and Client Secret can be either one from the Xero App if there are several created for different purpose.
Meanwhile for “Xero Scope”, we are using minimum set of scope required to be able to read invoice and the contact*:
email profile openid accounting.transactions accounting.contacts offline_access
The OAuth 2.0 redirect URI for UAT should be: https://uat.redplanetsoftware.com/odyv4/xerocallback

* For more details regarding Xero application scope, please refer to: https://developer.xero.com/documentation/oauth2/scopes

Step 2

After Xero OAUTH2 settings above is saved, broker user that wants to integrate his/her broker/firm with Xero will need to login into Quickfee Portal.

Step 3

Clicking “Allow access” will then takes the user back to Quickfee Portal where the authorization token will be processed and stored in the system. This will be used in QSOP to read the Xero invoice and client details.

Step 4

Once done as above, the user can either back to home, logout or close the browser as the connection has been successfully established and the connection token is stored in the system. Clicking back to home will then show that the company it is already connected to.

Step 5

This is the setup that the firm needs to do in their own Xero account to be able to pay via QSOP.

The link to QSOP will remain the same as before, assuming that the firm has set QSOP as the payment service to pay the Xero invoice, similar like below, with the custom URL in the format of: https://localhost/qsopus/#/company/quickfee/firm/demo/invoiceNo/[INVOICENUMBER]/amount/[AMOUNTDUE]

Note: demo should be the creditor/firm code assigned as per Odyssey Creditor Maintenance.

Step 6

On the Xero invoice, the top left link will then contain the link to pay the invoice via QSOP.

Step 7

Clicking the link will then take the user to QSOP which then loads that invoice and any outstanding invoice (if any).(https://localhost/qsopus/#/company/quickfee/firm/demo/invoiceNo/INV-2009/amount/2200.00)

Step 8

Select the invoice to be paid and processed and then click ‘Continue’ and fill in the required details on the next screen, including the payment details.