Push Transactions (XML)

Description

This Push Transaction message delivers a notification that a payment or refund has occurred by Levart or a third party payment gateway.

Note

Transactions can be unrelated to bookings i.e. paying for a drinks at the bar. It is still recommended to confirm every Transaction as any unconfirmed transactions will continue to be sent until confirmation is received.

Direction

Levart → PMS

Request

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soap12:Body>
        <TransactionNotifRQ xmlns="http://www.levart.com.au/">
            <Authentication>
                <Username>dfdsfsdf</Username>
                <Password>abc123</Password> 
            </Authentication>
            <TimeStamp>2024-02-22T09:29:42+08:00</TimeStamp>
            <MessageID>1d435751-4c4a-4c92-b705-7d6579f4f14e</MessageID>
            <MessageType>PushTransaction</MessageType>
            <TransactionData>
                <TransactionID>682</TransactionID>
                <RelatedReference>58020193</RelatedReference>
                <RelatedSource>Levart</RelatedSource>
                <GatewayID>StripeSmart</GatewayID>
                <GatewayReference>pi_3OmQsyGh4NcHCnHJ0HQfyb7S</GatewayReference>
                <CardMask>XXXXXXXXXXXX4444</CardMask>
                <CardType>visa</CardType>
                <Type>Payment</Type>
                <Currency>AUD</Currency>
                <CardFee>0.91</CardFee>
                <TransactionFee>0.00</TransactionFee>
                <AmountNet>85.40</AmountNet>
                <AmountGross>86.31</AmountGross>
                <ProcessedTime>2024-02-22T09:15:45+08:00</ProcessedTime>
                <Description>Deposit - Full Payment</Description>
            </TransactionData>
        </TransactionNotifRQ>
    </soap12:Body>
</soap12:Envelope>

Specification XML Request

Element	Num	Type	Description
Authentication	1	Object	Authentication object
Authentication > Username	1	String	Unique username for the property.
Authentication > Password	1	String	Unique password for the property.
MessageID	1	String	Unique Message ID
MessageType	1	String	Set to 'PushTransaction'
TimeStamp	1	DateTime	Date and time of the transaction in ISO 8601 format. e.g. 2024-01-28T15:15:00+08:00
TransactionData	1	Object	TransactionData object
TransactionData > TransactionID	1	String	Unique ID for Levart
TransactionData > RelatedReference	1	String	Related booking reference.
TransactionData > RelatedSource	1	String	The source of the booking e.g. Levart, Booking.com, Expedia
TransactionData > GatewayID	1	String	The gateway identifier. e.g. LevartPay, StripeSmart
TransactionData > GatewayReference	1	String	The reference given by the payment gateway for this payment.
TransactionData > CardMask	1	String	Masked out card detailed used to make the payment.
TransactionData > CardType	1	String	Card type: visa, mastercard, amex, dinersCard
TransactionData > Type	1	String	Payment or Refund
TransactionData > Currency	1	String	Currency of the transacion e.g. AUD, USD or NZD
TransactionData > CardFee	1	Currency	Card fee included in the transaction
TransactionData > TransactionFee	1	Currency	Transaction fee included in the transaction
TransactionData > AmountNet	1	Currency	Amount of the transaction net of any TransactionFee or CardFee
TransactionData > AmountGross	1	Currency	Gross amount of the transation including all fees
TransactionData > ProcessedTime	1	DateTime	Time the transaction was processed by the payment gateway.
TransactionData > Description	1	String	Free form description text e.g. First nights accommodation.

Response (Success)

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soap12:Body>
        <TransactionNotifRS xmlns="http://www.levart.com.au/">
            <MessageID>1d435751-4c4a-4c92-b705-7d6579f4f14e</MessageID>
            <TimeStamp>2024-02-22T09:29:42+08:00</TimeStamp>
            <Status>Success</Status>
            <ConfirmationID>234234</ConfirmationID> 
        </TransactionNotifRS>
    </soap12:Body>
</soap12:Envelope>

Response (Error)

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soap12:Body>
        <TransactionNotifRS xmlns="http://www.levart.com.au/">
            <MessageID>1d435751-4c4a-4c92-b705-7d6579f4f14e</MessageID>
            <TimeStamp>2024-02-22T09:29:42+08:00</TimeStamp>
            <Status>Error</Status>
            <ErrorMessage>Invalid username or password.</ErrorMessage> 
        </TransactionNotifRS>
    </soap12:Body>
</soap12:Envelope>

Specification XML Response

Element	Num	Type	Description
MessageID	1	String	Unique Message ID (Same as the Request Message ID)
TimeStamp	1	DateTime	Date and time of the transaction in ISO 8601 format. e.g. 2016-01-28T15:15:00+08:00
Status	1	String	Element contains either Error or Success
ErrorMessage	0..1	String	The error message description (On Error).
ConfirmationID	0..1	String	The Confirmation string provided by the PMS system (On Success).