Response

When a transaction is processed, the SDK will pass through the transaction details to the first parameter of the onSuccess callback.

The response payload contains a number of attributes with a complete description of the transaction model in our online API documentation.

Key response attributes include:

Claim response attributes

When a transaction is processed, the SDK will pass through the transaction details to the first parameter of the onSuccess callback.

The response payload contains a number of attributes with a complete description of the transaction model in our online API documentation.

Key response attributes include

Field Format Example value Description
_id 128 characters 5ce4d63cb0a38c005582b838 Tyro Health Online unique transaction reference
patient {} Object Patient names as validated with WorkSafe Victoria
patient.firstName Up to 40 characters Willis Patient first / given name as registered with icare.
patient.lastName Up to 40 characters Curtin Patient last / family name as registered with WorkSafe Victoria.
patient.dobString string 1991-13-06 Date of birth in YYYY-MM-DD format.
practice Object
practice.id string 61f7297f272329006343997e Internal practice ID
practice.fullName string Name of practice
claims Object
claims.status 256 characters Approved Description of overall claim/quote
claims.statusDescription Payment Approved Description of the status
claims.gatewayCode 00 Claim item gateway response code
claims.amountExpectedBenefitString integer 8000 / $80.00 Total claim benefit amount in cents or (string) in currency notation WorkSafe Victoria is expected to pay.
claimItems.amountActualBenefitString string $50.00 The amount WorkSafe Victoria has approved to pay in currency format. E.g. $119.95.
claims.amountGap/claims.amountGapString 6000 / $60.00 Total claim gap (employee payable) amount in cents or (string) in currency notation.
claims.claimItems Array For each claimed item, a separate line level response as below.
claims.claimItems.status 256 characters Approved Description of the claim/quote item level status
claims.claimItems.gatewayCode String 00 Claim gateway response code
claims.claimItems.amountActualBenefit / claims.claimItems.amountActualBenefitString 4000 / $40.00 Claim item benefit amount in cents or (string) in currency notation.
claims.claimItems.amountGap/ claims.claimItems.amountGapString 2500 / $25.00 Claim item gap (member payable) amount in cents or (string) in currency notation.

Transaction object response on success(root level attributes):

Copy
Copied
{
_id: string
abn: string
amountBalance: number
amountBalanceString: string
amountCharged: number
amountChargedString: string
amountClaimsActualBenefit: number
amountClaimsActualBenefitString: string
amountClaimsExpectedBenefit: number
amountClaimsExpectedBenefitString: string
amountClaimsGap: number
amountClaimsGapString: string
amountFee: number
amountFeeNet: number
amountFeeNetString: string
amountFeeString: string
amountItemsCharged: number
amountItemsChargedString: string
amountItemsFee: number
amountItemsFeeString: string
amountOutOfPocket: number
amountOutOfPocketString: string
amountOutstanding: number
amountOutstandingString: string
amountRefund: number
amountRefundString: string
amountTax: number
amountTaxString: string
application: Object
businessId: string
businessStatus: string
claims: [
   amountActualBenefit: number
   amountActualBenefitString: string
   amountExpectedBenefit: number
   amountExpectedBenefitString: string
   amountGap: number
   amountGapString: string
   beneficiary: string
   claimDateString: string
   claimId: string
   claimItems: Object
   claimType: string
   createdByAccountId: string
   createdByAccountUsername: string
   funder: Object
   gatewayCode: string
   healthFund: Object
   healthFundAccount: Object
   professionalCategory: Object
   providerNumber: string
   requested: string
   responded: string
   specialties: Object
   specialty: Object
   status: string
   statusDescription: string
   statusHistory: Array
   _id: string
]
created: string
createdByAccountUsername: string
items: Array
modified: string
originatingFlow: string
patient: Object
payments: Array
practice: Object
staff: Object
transactionId: string
transactionType: string
webhooks: Array
}

On Error response will either be a string or an object.

Transaction object response onError object (root level attributes):

Copy
Copied
{
  "statusCode": number,
  "error": string,
  "message": string,
  "errorCode": number,
  "errors": [
    {
      "message": string,
      "attribute": string
    }
  ]
}
2024 Copyright © Tyro Health and Tyro Payments 2024. All right reserved.