IATA BSP EasyPay Payment

IATA EasyPay payment is used for airline transactions that are settled through IATA EasyPay rather than by credit card. The amount is authorised and debited from the agent’s IATA EasyPay account and reported to IATA for settlement in accordance with IATA EasyPay procedures and timelines.

XML Samples

How to Implement IATA BSP EasyPay Payment

OrderCreateRQ and OrderChangeRQ

You need to update PaymentFunctions adding 1. PaymentMethodCriteria, 2. PaymentTypeCode, 3. IATA_EasyPay, 4. AccountNumber, 5. ExpirationDate, 6. SettlementPlan, and 7. PaymentTypeCode in OrderCreateRQ.

OrderCreateRQ

<IATA_OrderCreateRQ>
...
<PaymentFunctions
    xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
    <PaymentProcessingDetails>
        <Amount CurCode="GBP">523.89</Amount>
        <PaymentMethod>
            <IATA_EasyPay>
                <AccountNumber>2235291443635766</AccountNumber>
                <ExpirationDate>1225</ExpirationDate>
            </IATA_EasyPay>
        </PaymentMethod>
    </PaymentProcessingDetails>
</PaymentFunctions>
...
</IATA_OrderCreateRQ>

<IATA_OrderCreateRQ>
...
<PaymentFunctions
    xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
    <PaymentProcessingDetails>
        <Amount CurCode="GBP">4.10</Amount>
        <Payer>
            <PayerName>
                <IndividualName>
                    <GivenName>David</GivenName>
                    <Surname>Smith</Surname>
                </IndividualName>
            </PayerName>
        </Payer>
        <PaymentMethod>
            <PaymentCard>
                <CardholderAddress>
                    <CityName>Crawley</CityName>
                    <CountryCode>GB</CountryCode>
                    <PostalCode>RH108HA</PostalCode>
                    <StreetText>8</StreetText>
                    <StreetText>Cobbles Crescent</StreetText>
                </CardholderAddress>
                <CardNumber>52012Y1HNJGI9736</CardNumber>
                <CardSecurityCode>123</CardSecurityCode>
                <CardTypeText>CA</CardTypeText>
                <ExpirationDate>1226</ExpirationDate>
                <SecurePaymentVersion2>
                    <AuthenticationValue>ODQzNjgwNjU0ZjM3N2JmYTg0NTM</AuthenticationValue>
                    <DirectoryServerTrxID>c272b04f-6e7b-43a2-bb78-90f4fb94aa25</DirectoryServerTrxID>
                    <ElectronicCommerceInd>02</ElectronicCommerceInd>
                    <TrxStatusText>Y</TrxStatusText>
                </SecurePaymentVersion2>
                <SecureProgram>
                    <EnrollmentStatusText>CardEnrolled3DS2.1.0</EnrollmentStatusText>
                </SecureProgram>
            </PaymentCard>
        </PaymentMethod>
    </PaymentProcessingDetails>
</PaymentFunctions>
...
</IATA_OrderCreateRQ>

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. IATA_Number - (Mandatory) - Denotes that the payment is made via IATA EasyPay Cash.
2. ApprovalCode - (Optional) - Authorisation Result: Approval Code

The first PaymentFunctions section below contains information related to an even exchange. You will see the Amount is 0, and PaymentBrandCode and PaymentTypeCode is OT. 

OrderViewRS

<IATA_OrderViewRS>
...
<PaymentFunctions>
    <OrderAssociation
        xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
        <OrderItemRefID>VS932RNWGBL25-1A</OrderItemRefID>
        <OrderRefID>VS932RNWGBL25</OrderRefID>
    </OrderAssociation>
    <PaymentProcessingSummary
        xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
        <Amount CurCode="GBP">0.00</Amount>
        <PaymentCommitmentDateTime>2025-11-28T16:02:00Z</PaymentCommitmentDateTime>
        <PaymentID>176434573472416261</PaymentID>
        <PaymentProcessingSummaryPaymentMethod>
            <OfflinePayment>
                <PaymentBrandCode>OT</PaymentBrandCode>
                <PaymentTypeCode>OT</PaymentTypeCode>
            </OfflinePayment>
        </PaymentProcessingSummaryPaymentMethod>
        <PaymentStatusCode>SUCCESSFUL</PaymentStatusCode>
    </PaymentProcessingSummary>
</PaymentFunctions>
<PaymentFunctions>
    <OrderAssociation
        xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
        <OrderItemRefID>VS932RNWGBL25-1</OrderItemRefID>
        <OrderRefID>VS932RNWGBL25</OrderRefID>
    </OrderAssociation>
    <PaymentProcessingSummary
        xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
        <Amount CurCode="GBP">523.89</Amount>
        <PaymentCommitmentDateTime>2025-11-28T16:01:31Z</PaymentCommitmentDateTime>
        <PaymentID>17643456917726561</PaymentID>
        <PaymentProcessingSummaryPaymentMethod>
            <IATA_EasyPay>
                <ApprovalCode>078149</ApprovalCode>
            </IATA_EasyPay>
        </PaymentProcessingSummaryPaymentMethod>
        <PaymentStatusCode>SUCCESSFUL</PaymentStatusCode>
    </PaymentProcessingSummary>
</PaymentFunctions>
...
</IATA_OrderViewRS>