Hahn Air NDC 2017.2 API – Cash Payments

 

Cash payments are now supported in our Hahn Air NDC platform. For now, this is limited to BSP markets; ARC markets will be coming later.

Payments using Cash are available for all accredited IATA Agencies, whether they have already issued non-NDC Hahn Air tickets or not.

To know whether your IATA Agency is ready to use BSP Cash in our Hahn Air NDC platform, please contact us at: ndc@hahnair.com

Cash Form of Payment in Hahn Air NDC APIs

 

  • AirShoppingRS and OfferPriceRS

Sellers that are eligible to use Cash (based on AgencyID) will receive ‘CASH’ as an accepted form of payment in AirShoppingRS and OfferPriceRS. This is returned along with other Payment Cards that are accepted in the market. Details about this can be found in the AirShoppingRS documentation and OfferPriceRS documentation, under the section:

[Message].Metadata.Other.OtherMetadata.CurrencyMetadatas.PaymentCardMetadatas.PaymentCardMetadata

 

  • OrderCreateRQ

Details about how to send Cash form of payment can be found in our OrderCreateRQ documentation, under the sections:

OrderCreateRQ.Query.Payments.Payment
OrderCreateRQ.Query.Payments.Payment.Method – Cash

You will also find samples showing how Cash payment method is used.

 

  • OrderViewRS

After the Order has been created, you will receive a summary of the payment, including the total payment amount and the form of payment information. Details about this can be found in our OrderViewRS documentation, under the sections:

OrderViewRS.Response.Order.Payments.Payment
OrderViewRS.Response.Order.Payments.Payment.Method.CashMethod

You will also find samples showing Orders paid using Cash.

 

Important considerations

 

Please note that using BSP cash has two important implications. We ask you to read carefully before sending Cash as a Form of Payment.

 

  • Difference in price of Offer and Order

In rare cases, the price presented in the Offer (in AirShoppingRS or OfferPriceRS) is slightly different to the final price of the Order. This can be caused by small exchange rate or tax computation anomalies in the Offer and the Order pricing processes.

To enhance the customer experience and avoid unnecessary Order Create failures, we have implemented a 1.00 (one) EUR tolerance (or equivalent in local currency). We proceed with the Order creation if the total price of the Order is within that tolerance (either higher or lower).

 

For Card payments:

If the price presented in the Offer is higher than the final price of the Order, we will authorize the amount presented in the Offer, but will only capture the price of the Order. Result: we charge the lower amount.

Presented Offer priceFinal Order priceAuthorized amountCaptured amount
100.0099.95100.0099.95

If the price presented in the Offer is lower than the final price of the Order, we will authorize and capture the amount presented in the Offer. Result: we honor the original Offer price.

Presented Offer priceFinal Order priceAuthorized amountCaptured amount
100.00100.05100.00100.00

For card payments, the final amount captured is never more than the original price of the Offer.

 

For Cash payments:

It is required that we report the correct value of the ticket to the BSP, and this value will be used for billing and settlement. To maintain a good customer experience and avoid unnecessary Order creation failures, in the rare instance where there is a difference between the price that was offered, and the price of the Order (within tolerance, whether higher or lower), we will report the actual value on the ticket. This is the amount that will be billed to the IATA Agency. As a result, the IATA Agency may be charged slightly more, or slightly less, than what was presented in the Offer, but always within the 1.00 (one) EUR tolerance (or equivalent in local currency).

Presented Offer priceFinal Order priceAmount reported to the BSP (Reporting on Ticket basis)Amount billed by the BSP (Billing on Ticket basis)
100.0099.9599.9599.95
100.00100.05100.05100.05

Whereas these discrepancies are rare, we are working to remove them completely by the end of 2021.

 

  • Servicing NDC Orders paid with Cash

As we have not exposed our Servicing APIs yet, we ask you to use the following processes to service NDC Orders paid with Cash:

Exchanges: The Agency should perform the change in our web portal or send a request by submitting the NDC Change Form. If there is an additional collection resulting from an Exchange, it can only be paid using Credit Card.

Refunds: The Agency should send a request by submitting the NDC Cancellation Form, and then submit a Refund Application using BSP Link.

 

Assistance

 

In case you have any questions or need assistance with your Cash integration, please contact us at: ndc@hahnair.com