Knowledgebase
Deposit and Cancellation Information, Receipt Saving, and Deposit Amount in an XML Save Booking
Posted by Jeff Tweddale on 06 Jul 2026 11:58 AM

Deposit and Cancellation Information and Amounts using the XML Service

If you’re using the XML calls and you want to determine what setting to use you to save a booking with the Site’s Deposit and Cancelaltion policy text, policy, and amount, you should follow the steps below: 

#1 -  Make a call OTA_HotelDescriptiveContentInfo - Site Information: Policies 

Type: Policies

OTA_HotelDescriptiveContentInfoPort  
Test end point: https://ws-server-test.bookingcenter.com/hotel_information.php?wsdl

This will return the key attributes you need to make the OTA_HotelResPort (New Booking call) 

Guarantee Type (GuaranteeType)

1

If empty  (No deposit) 

2

GuaranteeRequired

3

Deposit 

 

GuaranteePayment

1

% Percent 

!Percent

2

Number of Nights

!NmbrOfNights  

3

Deposit  

!Flat

 

 

Sample PHP/SOAP code: 

Sample code for Flat fee if $55.00

<GuaranteePayment GuaranteeType="Deposit" PaymentCode="8">
<AmountPercent TaxInclusive="yes" FeesInclusive="yes" Flat="55.00" BasisType="FullStay" DecimalPlaces="2" />  </GuaranteePayment>

 

Sample code for % deposit of 50%

<GuaranteePayment GuaranteeType="Deposit" PaymentCode="8">

<AmountPercent TaxInclusive="yes" FeesInclusive="yes" Percent="50.00" BasisType="FullStay" DecimalPlaces="2" />

</GuaranteePayment>

 

 

Sample code for 1 night deposit

<GuaranteePayment GuaranteeType="Deposit" Duration="Day" PaymentCode="8">

<AmountPercent TaxInclusive="yes" FeesInclusive="yes" NmbrOfNights="1" BasisType="Nights" DecimalPlaces="0" />

</GuaranteePayment>

 

 

Sample code for No Deposit will have no code available. 

 

Additional code to ensure you have all the settings set 

$guarantee_type = $hotel[ 'Policies' ][ 'Policy' ][ 'GuaranteePaymentPolicy' ][ 'GuaranteePayment' ][ '!GuaranteeType' ]; //i.e. Deposit

$guarantee_percent = $hotel[ 'Policies' ][ 'Policy' ][ 'GuaranteePaymentPolicy' ][ 'GuaranteePayment' ][ 'AmountPercent' ][ '!Percent' ];

$deposit_tax_inc = $hotel[ 'Policies' ][ 'Policy' ][ 'GuaranteePaymentPolicy' ][ 'GuaranteePayment' ][ 'AmountPercent' ][ '!TaxInclusive' ];

$policy_deposit_num_nights = $hotel[ 'Policies' ][ 'Policy' ][ 'GuaranteePaymentPolicy' ][ 'GuaranteePayment' ][ 'AmountPercent' ][ '!NmbrOfNights' ];

$deposit_flat_amount = $hotel[ 'Policies' ][ 'Policy' ][ 'GuaranteePaymentPolicy' ][ 'GuaranteePayment' ][ 'AmountPercent' ][ '!Flat' ];

$apply_taxes_to_deposit = $hotel[ 'Policies' ][ 'Policy' ][ 'GuaranteePaymentPolicy' ][ 'GuaranteePayment' ][ 'AmountPercent' ][ '!TaxInclusive' ];

 

if ( empty( $guarantee_type )or $guarantee_type == "" ) { //no deposit

  $deposit_payment_basis = 4;

  $deposit_amount = 0;

  $deposit_tax_inc = "no";

} elseif ( $guarantee_type == "GuaranteeRequired" ) {

  $deposit_payment_basis = 1;

  $deposit_amount = 0;

  $deposit_tax_inc = "no";

} elseif ( $guarantee_type == "Deposit" ) {

  if ( $policy_deposit_num_nights == 1 ) { //1-night deposit 

    $deposit_payment_basis = 2;

    $deposit_amount = 0;

    //$deposit_tax_inc = 0;

  } else { // % deposit

    $deposit_payment_basis = 3;

    $deposit_amount = $guarantee_percent;

    //$deposit_tax_inc = 0;

  }

}

 


Comments (0)
Post a new comment
 
 
Full Name:
Email:
Comments:
CAPTCHA Verification 
 
Please enter the text you see in the image into the textbox below (we use this to prevent automated submissions).