Skip to content

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. The key attributes are listed below.

Key response attributes include:

FieldFormatDescriptionExample value
id128 charactersTyro Health Online unique transaction reference5ce4d63cb0a38c005582b838
patient {}ObjectPatient names as validated with DVA - note that updated name details may be returned.
patient.firstNameUp to 40 charactersPatient first / given name as registered with DVA.Willis
patient.lastNameUp to 40 charactersPatient last / family name as registered with DVA.Mia
patient.dobStringstringDate of birth in YYYY-MM-DD format.1991-13-06
practiceObject
practice.idstringInternal practice ID61f7297f272329006343997e
practice.fullNamestringName of practice
claimsObject
claims.status256 charactersDescription of overall claimApproved
claims.statusDescriptionDescription of the statusPayment Approved
claims.gatewayCodeClaim item gateway response code00
claims.amountExpectedBenefitStringintegerTotal claim benefit amount in cents or (string) in currency notation DVA is expected to pay.8000 / $80.00
claimItems.amountActualBenefitStringstringThe amount DVA has approved to pay in currency format. E.g. $119.95.$50.00
claims.amountGap/ claims.amountGapStringTotal claim gap (employee payable) amount in cents or (string) in currency notation.6000 / $60.00
claims.claimItemsArrayFor each claimed item, a separate line level response as below.
claims.claimItems.status256 charactersDescription of the claim/quote item level statusApproved
claims.claimItems.gatewayCodeStringClaim gateway response code00
claims.claimItems.amountActualBenefit / claims.claimItems.amountActualBenefitStringClaim item benefit amount in cents or (string) in currency notation.4000 / $40.00
claims.claimItems.amountGap/ claims.claimItems.amountGapStringClaim item gap (member payable) amount in cents or (string) in currency notation.2500 / $25.00
externalReferences{}Key-pair objectServices Australia transaction IDs - for provider support requests to DVA.



Transaction object response on success(root level attributes):

{
_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):

{
  "statusCode": number,
  "error": string,
  "message": string,
  "errorCode": number,
  "errors": [
    {
      "message": string,
      "attribute": string
    }
  ]
}