Creating Microkeeper Account via API

This guide will explain how to create a Microkeeper account via the API.

This is only for Resellers of Microkeeper that have been whitelisted.

Complete a Hello World API call

Before starting this tutorial make sure you have completed the Hello World tutorial.

Creating and updating a Microkeeper accounts via API

Reseller Access

Step 1

In this scenario the reselling is doing the billing of Microkeeper and they are provisioning the Microkeeper account.

The reseller must include links to our Terms of use and Privacy Policy as part of the account provisioning process, with a checkbox sign process included.

They will need to store the returned mk_biz_key if they wish to utilise other API endpoints.

There is a vetting process to becoming a reseller.

Required Variables

Step 2

Set the mk_action variable and mk_data variable:

Since there is no Microkeeper account yet, the mk_biz_key must be set to that of the developer.

The API will check that the integrator has reseller rights with Microkeeper, if not an error will be returned.

mk_data Payload

Step 3

API Response

Step 4

If successful Microkeeper will response with the following fields in the data object:

Example

JSON response:

{"success":1,"authenticated":1,"message":"Registration Successful","data":{"username":"abc_engineering","mk_biz_key":"tt50SukqohfGwcwlyyxtPWOF390UXdBv","business_id":"abc123","update":1}}

Same response as an array:

Array
(
    [success] => 1
    [authenticated] => 1
    [message] => Registration Successful
    [data] => Array
        (
            [username] => abc_engineering
            [mk_biz_key] => tt50SukqohfGwcwlyyxtPWOF390UXdBv
            [business_id] => abc123
            [update] => 1
        )
)

Things to Test

Step 5

1. Make sure if the same business_id is passed multiples times only one account is created.
   The username returned should always be the same and update should be set to 0 on the first API call and 1 for each API call after that.
   
   
2. If success is set to 0 then message is an error message and best practice would be to return this to the user.
   Example "ABN is not valid"
   
   
3. Test a business name with special characters to make sure they are encoded correctly and not breaking the JSON.
   Microkeeper will sanitise this data, so it's likely some characters will be removed, but still pass validation.
   Example ABC ~!@#$%^&*()_+`1{{}|[]\:",./?>< PTY LTD
   
   
4. If compromised a mk_biz_key will need to be replaced, so it should be possible to run the provisioning process again.

Adding a Bank account Via API

When provisioning an account you can add the business bank account.

This step is optional, bank accounts can also be managed in Microkeeper.

The account holder will still need to go through a verification process for the primary bank account before paying super.

Required Variables

Step 1

Set the mk_action variable and mk_data variable:

mk_data Payload

Step 3

List of all BSBs

http://bsb.apca.com.au/

This list of BSB is maintained, it's recommended to update your application on a periodic basis.

Example monthly for high volume or annually for low volume.

bank_code list

ANZ has some inconsistency between ANZ products, so workarounds need to be in place when generating the ABA file, AN2 and AN3 are converted to ANZ when the ABA file is created

Responses

{ "success":"1", "authenticated":"1", "message":"Bank account added" }

If a bank account is already present with the same details, the response success will still be true.

{ "success":"1", "authenticated":"1", "message":"This bank account is already present" }

Failed response

{ "success":"0", "authenticated":"1", "message":"BSB not found" }