Samples of the XML Message Exchange between TruModule and TruService when TruModule requires a question are given below. This is a typical message exchange between TruModule and TruService where:

  • Module requests a question from TruService (A);
  • TruService responds with a question (B);

(The ‘A’ and ‘B’ markers refer to the relevant annotations in the customer journey UML diagrams when these messages are used.)

The full specification for the TruService XML messages can be found here

TruModule requests a question (A)

<?xml version="1.0" encoding="UTF-8"?>
<Request PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
  <Question Trigger="PAYMENTREQUEST">
    <Language Rfc1766="en-GB"/>
    <Device Name="MX925" Firmware="FORMAGENT 2.0" >
      <Screen Height="4" Width="64" Format="RAW" Font="MONOSPACED" Separator="\n" Unit="LINE"/>
      <Receipt Height="30" Width="255" Format="RAW" Font="MONOSPACED" Separator="\n" Unit="LINE"/>
    </Device>
    <Server Id="14839345987423827P" Firmware="MCM.42" />
  </Question>
</Request>

TruService responds with a question (B)

<?xml version="1.0" encoding="UTF-8"?>
<Response PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
    <Display>
      <Language Rfc1766="en-GB">
        <Question TimeoutMs="30000">truRating:Please rate the product range from 0-9 or clear</Question>
        <Screen TimeoutMs="3000" When="RATED" Priority="false">Thanks for rating!</Screen>
        <Screen TimeoutMs="3000" When="NOTRATED" Priority="false">Sorry you didn't rate</Screen>
        <Receipt When="RATED" Priority="false" Type="CUSTOMER">************************************************   Thanks for rating!     Go to trurating.com          for ratings           you can trust.     ************************************************</Receipt>
        <Receipt When="NOTRATED" Priority="false" Type="CUSTOMER">************************************************   Sorry you didn't rate     Go to trurating.com          for ratings           you can trust.     ************************************************</Receipt>
      </Language>
    </Display>
</Response>
Feedback