UpdateBearer

Updates the firstName, lastName, cellphone and ID number linked to an allocated card.

Request Path Parameters

Parameter	type	Limits	required	Description
terminalID	String	10 characters	✓	The Paymentology issued terminal ID of the terminal requesting the transaction.
profileNumber	String	1-20 characters	✓	The profile to which the card belongs.
cardIdentifier	String	1-20 characters	✓	The card number, tracking number or sequence number of the card to update.
firstName	String	1-100 characters	✓	The first name of the card bearer.
lastName	String	1-100 characters	✓	The last name of the card bearer.
idOrPassportNumber	String	1-50 characters	✓	The ID or passport number of the card bearer.
cellphoneNumber	String	1-20 characters	✓	The cellphone number of the card bearer.
transactionID	String	1-255 characters	✓	Transaction ID number generated by the calling client.
transactionDate	Date		✓	Transaction date generated by the calling client.
checksum	String		✓	HMAC-SHA1 hashed signature of the concatenated method name with all argument values using the terminal password as private key.

<?xml version="1.0"?>
<methodCall>
  <methodName>UpdateBearer</methodName>
  <params>
    <param>
      <value>
        <string>1876543896</string>
      </value>
    </param>
    <param>
      <value>
        <string>8765452147</string>
      </value>
    </param>
    <param>
      <value>
        <string>231456202589631</string>
      </value>
    </param>
    <param>
      <value>
        <string>John</string>
      </value>
    </param>
    <param>
      <value>
        <string>Snow</string>
      </value>
    </param>
    <param>
      <value>
        <string>2563021238965</string>
      </value>
    </param>
    <param>
      <value>
        <string>4321 321 123</string>
      </value>
    </param>
    <param>
      <value>
        <string>f41256s0aa21abcdef123456a25ffeba</string>
      </value>
    </param>
    <param>
      <value>
        <dateTime.iso8601>20230210T13:16:23</dateTime.iso8601>
      </value>
    </param>
    <param>
      <value>
        <string>e694a6e09b15bc1d139428593d919e5081f36e8e</string>
      </value>
    </param>
  </params>
</methodCall>

Response Parameters

Parameter	type	Description
terminalID	String	Echo of incoming value.
profileNumber	String	Echo of incoming value.
cardNumber	String	Number of the card found using the cardIdentifier.
cardSequenceNumber	String	Sequence of the card found using the cardIdentifier.
firstName	String	Echo of incoming value.
lastName	String	Echo of incoming value.
cellphoneNumber	String	Echo of incoming value.
clientTransactionID	String	Echo of incoming value.
serverTransactionID	Date	Transaction id generated by Paymentology.
resultCode	Integer	Status code indicating the transaction result.
resultText	String	Text indicating the transaction result.

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>clientTransactionID</name>
            <value>
              <string>f41256s0aa21abcdef123456a25ffeba</string>
            </value>
          </member>
          <member>
            <name>resultCode</name>
            <value>
              <int>1</int>
            </value>
          </member>
          <member>
            <name>terminalID</name>
            <value>
              <string>1876543896</string>
            </value>
          </member>
          <member>
            <name>profileNumber</name>
            <value>
              <string>8765452147</string>
            </value>
          </member>
          <member>
            <name>cardNumber</name>
            <value>
              <string>5987656789000307</string>
            </value>
          </member>
          <member>
            <name>lastName</name>
            <value>
              <string>Snow</string>
            </value>
          </member>
          <member>
            <name>cardSequenceNumber</name>
            <value>
              <double>23695</double>
            </value>
          </member>
          <member>
            <name>resultText</name>
            <value>
              <string>OK</string>
            </value>
          </member>
          <member>
            <name>firstName</name>
            <value>
              <string>John</string>
            </value>
          </member>
          <member>
            <name>serverTransactionID</name>
            <value>
              <string>1293415715-s521a6e09b15bc1d5236sx5236d919e5081452xsd</string>
            </value>
          </member>
          <member>
            <name>cellPhoneNumber</name>
            <value>
              <string>4321 321 123</string>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>