How to Manage fee Profiling

A guide to the Fee Profiling functionality to support businesses with this requirement via our REST API.

Please speak to your Account Manager regarding the eligibility of enabling this function for your integration.

This function allows you to specify a Fee Profile to be applied on a per transaction basis and can be used via Schedule a single payment API and eCommerce live card/tokenised API. This function is not enabled by default and is subject to approval with the fee details agreed upon in the application form.

A new parameter needs to be included in the API when using the functionality - “Profile”.

Possible scenarios:

If “Profile' parameter is not included in the API call, Profile 1 is automatically applied.
If “Profile” parameter included in the API call:
- Value '1' = profile 1 will be applied
- Value '2' = profile 2 will be applied
- Other value = error is returned

Sample API:

Profile 1 = Business Paid

JSON

{
    "ProcessType": "COMPLETE",
    "Reference": "FeeProfiling T10",
    "Description": "This is an example real-time transaction",
    "Amount": 100.00,
    "Profile": 1,
    "CardToken": "2ac36f28fccf48ffa846678bf8a59151",
    "ServiceDate": "2022-03-01T10:00:00+10:00",
    "Payer": {
    	"uniqueReference": "Testfake1",
    	"groupReference":"Testfake1",
    	"familyOrBusinessName":"Surname",
    	"givenName":"First Name",
    	"billingAddress":{"Line1": "1 Test St","Line2": "Test Building","Suburb": "Testville","State": "QLD","PostCode": "4001","Country": "AUS" },
    	"email":"test@test.com",
    	"phone":"0733331111",
    	"savePayer":"false"
    },
    "Audit": {
		"Username": "Example-User",
    	"UserIP": "1.2.3.4"
    }
  }

Sample response of Profile 1

JSON

{
    "transactionId": "RT869913",
    "reference": "FeeProfiling T10",
    "statusCode": "S",
    "subStatusCode": null,
    "statusDescription": null,
    "processedAmount": 100.00,
    "cardType": "Visa",

Profile 2 = Payer Paid

JSON

{
    "ProcessType": "COMPLETE",
    "Reference": "FeeProfiling T20",
    "Description": "This is an example real-time transaction",
    "Amount": 100.00,
    "Profile": 2,
    "CardToken": "1a1c6d12176e4c1fb04b9241c52f14f0",
    "ServiceDate": "2022-03-01T10:00:00+10:00",
    "Payer": {
    	"uniqueReference": "Testfake1",
    	"groupReference":"Testfake1",
    	"familyOrBusinessName":"Surname",
    	"givenName":"First Name",
    	"billingAddress":{"Line1": "1 Test St","Line2": "Test Building","Suburb": "Testville","State": "QLD","PostCode": "4001","Country": "AUS" },
    	"email":"test@test.com",
    	"phone":"0733331111",
    	"savePayer":"false"
    },
    "Audit": {
		"Username": "Example-User",
    	"UserIP": "1.2.3.4"
    }
  }

Sample response of Profile 2

JSON

{
    "transactionId": "RT869914",
    "reference": "FeeProfiling T20",
    "statusCode": "S",
    "subStatusCode": null,
    "statusDescription": null,
    "processedAmount": 104.00,
    "cardType": "Visa",