Travelfusion Direct Connect XML API > Guidelines > tfPay - Payment Travel Innovation & Settlement > tfPay Deposit
API Configuration - tfPay Deposit/Credit Method - Flights and Rail
This configuration is applicable only when bookings are processed as tfPay and not valid when using the tfMerchant and BillBack payment execution methods. In the ‘ProcessDetails’ response Travelfusion flags ‘UseTFPrepay’, as an optional RequiredParameter, if the booking is processed as a Travelfusion payment. Please note that this is a per-booking parameter and Travelfusion may not return ‘UseTFPrepay’, even if the booking is for the same supplier.
<RequiredParameterList>
<RequiredParameter>
<Name>UseTFPrepay</Name>
<DisplayText/>
<PerPassenger>false</PerPassenger>
<IsOptional>true</IsOptional>
</RequiredParameter>
</RequiredParameterList>
Later on, in ProcessTerms request, you need to submit one of two values under ‘UseTFPrepay’.
Here is where you specify the payment logic you selected (see ‘Payment Logic’ above).
Process Bookings by Applicable Criteria: Based on the payment details you submit, we will decide whether or not to process this booking as Travelfusion payment. This means that the card details may be submitted to the supplier. Therefore you always need to make sure that such credit card details are valid, otherwise the booking will fail.
Always Process Bookings as Travelfusion Payment: This booking will always be processed as Travelfusion payment, and the credit card details you submit to us will be ignored and will not be submitted to the supplier. In this case you may also choose to omit credit card details in your ProcessTerms request.
The final price we return in the ‘ProcessTerms’ response is the estimated price for the card type that was submitted to us in the Terms request. If you chose ‘Always Process Bookings as Travelfusion payment’, we will select a credit card type.
In ‘ProcessTerms’ request, the parameter ‘UseTFPrepay’ need to be submitted within the BookingProfile XML element, for the entire booking, and not on a per-passenger basis. In this stage you also need to submit the full billing details, which include full credit card details including the card type. If you are always submitting the parameter 'UseTFPrepay' with value 'Always', you may choose to omit credit card details in your ProcessTerms request.
<CustomSupplierParameterList>
<CustomSupplierParameter>
<Name>UseTFPrepay</Name>
<Value>Always</Value> -OR- <Value>WhenApplicable</Value>
</CustomSupplierParameter>
</CustomSupplierParameterList>
The ‘UseTFPrepay’ parameter gives you the flexibility on a per booking basis. Furthermore, it allows you to support a quick switch back to a non-payment by Travelfusion configuration. It is also useful to cater for cases, in which a payment method cannot be supported (i.e. you run out of credit). tfPay generates alerts and advises us when to inform you of such cases. We ask you to respond to these alerts as quickly as possible.
Booking stage: tfPay returns the final booking price, based on the response from the supplier. Price changes from the Terms stage to the final booking response are rare but we know they can happen, for various reasons. Please note that if you change the end-user’s card, before you submit the booking request to Travelfusion, you may need to cater for cases, in which the charge is higher than quoted in the ‘Terms’ response.
When a booking goes through tfPay method Travelfusion returns a message under ‘SupplierInfoList’ node of ProcessTerms response. Please note that this is an important and the only confirmation that you will receive indicating whether the booking is going to be made through the tfPay method.
<SupplierInfoList>
<SupplierInfo>
<DisplayName>Prepay Booking</DisplayName>
<InfoType>text</InfoType>
<Info>The booking is being processed through the prepay system</Info>
</SupplierInfo>
<SupplierInfoList>
Please ensure that your system can parse this. Failing such means that the booking is not being processed through the tfPay system. We request that your application handles these situations dynamically. Our operation team will advise you of any de-activation of the tfPay system when occurs.