IATA BSP Cash Payment

IATA BSP Cash Payment is used for airline transactions that are settled through the IATA Billing and Settlement Plan (BSP) without the use of a credit card. The amount is reported as a cash sale and included in the agent’s BSP billing for settlement according to IATA timelines.

 

XML Samples

     

How to Implement IATA BSP Cash Payment

 

OrderCreateRQ and OrderChangeRQ

 

You need to update PaymentFunctions adding 1. PaymentMethodCriteria, 2. PaymentTypeCode, 3. SettlementPlan, and 4. PaymentTypeCode in OrderCreateRQ.

OrderCreateRQ

<IATA_OrderCreateRQ>
...
<PaymentFunctions xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
    <PaymentMethodCriteria>
        <PaymentTypeCode>CA</PaymentTypeCode>
    </PaymentMethodCriteria>
    <PaymentProcessingDetails>
        <Amount CurCode="GBP">1160.78</Amount>
        <PaymentMethod>
            <SettlementPlan>
                <PaymentTypeCode>CA</PaymentTypeCode>
            </SettlementPlan>
        </PaymentMethod>
    </PaymentProcessingDetails>
</PaymentFunctions>
...
</IATA_OrderCreateRQ>

 
OrderChangeRQ

<IATA_OrderChangeRQ>
...
<PaymentFunctions xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
    <PaymentMethodCriteria>
        <PaymentTypeCode>CA</PaymentTypeCode>
    </PaymentMethodCriteria>
    <PaymentProcessingDetails>
        <Amount CurCode="GBP">1160.78</Amount>
        <PaymentMethod>
            <SettlementPlan>
                <PaymentTypeCode>CA</PaymentTypeCode>
            </SettlementPlan>
        </PaymentMethod>
    </PaymentProcessingDetails>
</PaymentFunctions>
...
</IATA_OrderChangeRQ>

   
OrderChangeRQ - Additional Collection

<IATA_OrderChangeRQ>
...
<PaymentFunctions xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <PaymentProcessingDetails>
                <Amount CurCode="GBP">139.00</Amount>
                <PaymentMethod>
                    <SettlementPlan>
                        <PaymentTypeCode>CA</PaymentTypeCode>
                    </SettlementPlan>
                </PaymentMethod>
            </PaymentProcessingDetails>
        </PaymentFunctions>
...
</IATA_OrderChangeRQ>

   
OrderChangeRQ - EvenExchange/Free Meals

We have added an amount of ‘0’ and set the PaymentTypeCode to OT for all monetary services that are provided free of charge, in line with IATA guidance.

For example, this applies to services such as flights and seats. If an exchange is even, or a seat service is provided free of charge, the PaymentFunctions element must be sent as shown below.

If a seat or exchange service is chargeable, the applicable amount must be sent along with the appropriate PaymentTypeCode.

For services that are always free of charge, such as meals or WHCR, these have not been included, as no payment is ever associated with them.

<IATA_OrderChangeRQ>
...
<PaymentFunctions
    xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
    <PaymentProcessingDetails>
        <Amount CurCode="GBP">0.00</Amount>
        <PaymentMethod>
            <OfflinePayment>
                <PaymentBrandCode>OT</PaymentBrandCode>
                <PaymentTypeCode>OT</PaymentTypeCode>
            </OfflinePayment>
        </PaymentMethod>
    </PaymentProcessingDetails>
</PaymentFunctions>
...
</IATA_OrderChangeRQ>

 

Please access the OrderCreateRQ and OrderChangeRQ page for the updates for PaymentFunctions/PaymentMethodCriteria AND SettlementPlan/PaymentTypeCode.

 

OrderCreate/OrderChange/OrderRetrieve - OrderViewRS

 

The OrderViewRS will contain the following:

1. SettlementPlan - (Mandatory) - Denotes that the payment is made via IATA BSP Cash.
2. IATA_Number - (Optional) - Your IATA- assigned Agency Number
3. PaymentTypeCode - (Mandatory) - Default 'CASH'

OrderViewRS

<IATA_OrderViewRS>
...
<PaymentFunctions>
    <OrderAssociation xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
        <OrderItemRefID>VS932TPDGMT25-1</OrderItemRefID>
        <OrderItemRefID>VS932TPDGMT25-2</OrderItemRefID>
        <OrderRefID>VS932TPDGMT25</OrderRefID>
    </OrderAssociation>
    <PaymentProcessingSummary xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
        <Amount CurCode="GBP">1160.78</Amount>
        <PaymentCommitmentDateTime>2025-11-25T13:02:20Z</PaymentCommitmentDateTime>
        <PaymentID>176407574019726582</PaymentID>
        <PaymentProcessingSummaryPaymentMethod>
            <SettlementPlan>
                <IATA_Number>91281035</IATA_Number>
                <PaymentTypeCode>CASH</PaymentTypeCode>
            </SettlementPlan>
        </PaymentProcessingSummaryPaymentMethod>
        <PaymentStatusCode>SUCCESSFUL</PaymentStatusCode>
    </PaymentProcessingSummary>
</PaymentFunctions>
...
</IATA_OrderViewRS>