Overview
The main purpose of the payment catalogue is for the airline to inform a seller
Which methods are accepted as payment
At a high level
At a granular level
Any additional information* that may be required for processing
Card Type
Authentication need
Supported 3DS
Information regarding redirection expected or not
How the payment method will be processed
Offline
Online
Any processing fees at a precise level
expressed as a percentage
expressed as a range of values and/or percentages
Information relating to clearance method
Info |
---|
Note |
Accepted Payment Methods
The type of payment can be expressed at different levels of granularity using PaymentTypeCode and, optionally, PaymentBrandCode.
Code Block | ||
---|---|---|
| ||
<PaymentSupportedMethod>
<PaymentBrandCode>VI</PaymentBrandCode>
<PaymentMethodAddlInfo>
<PaymentCardAddlInfo>
<CardProductTypeCode>Consumer</CardProductTypeCode>
<CardTypeText>debit card</CardTypeText>
</PaymentCardAddlInfo>
</PaymentMethodAddlInfo>
<PaymentTypeCode>CC</PaymentTypeCode>
</PaymentSupportedMethod> |
Additional information can be added depending on the payment type as illustrated below.
Additional Payment Information
Some payment methods require different data and even different flows, such as 3D Secure for authentication. Additional precision relating to a payment method and any additional information that may be required in processing it, can be specified using elements within PaymentMethodAddlInfo.
Card
Within PaymentCardAdditionalInfo, further precision relating to a payment method can be identified here:
Code Block | ||
---|---|---|
| ||
<PaymentSupportedMethod>
<PaymentMethodAddlInfo>
<PaymentCardAddlInfo>
<CardProductTypeCode>Consumer</CardProductTypeCode>
<CardTypeText>debit card</CardTypeText>
</PaymentCardAddlInfo>
</PaymentMethodAddlInfo>
</PaymentSupportedMethod> |
Further requirements for processing can be identified too, such as the need to verify and the supported version of 3D secure:
Code Block | ||
---|---|---|
| ||
<PaymentSupportedMethod>
<PaymentMethodAddlInfo>
<PaymentCardAddlInfo>
<SecurePaymentAuthenticationVersion>
<SupportedVersionText>3DS2</SupportedVersionText>
</SecurePaymentAuthenticationVersion>
<VerificationInd>true</VerificationInd>
</PaymentCardAddlInfo>
</PaymentMethodAddlInfo>
</PaymentSupportedMethod> |
Other
OtherPaymentAddlInfo is designed to allow further information relating to a payment method if necessary. A common use may be to identify additional characteristics needed for payment types marked "other". In the following example, Remarks are used to identify acceptance of a payment method called "New Payment Brand".
Code Block | ||
---|---|---|
| ||
<PaymentSupportedMethod>
<PaymentBrandCode>OT</PaymentBrandCode>
<PaymentMethodAddlInfo>
<PaymentOtherMethodAddlInfo>
<Remark>
<DisplayInd>true</DisplayInd>
<RemarkText>Paypal</RemarkText>
</Remark>
</PaymentOtherMethodAddlInfo>
</PaymentMethodAddlInfo>
<PaymentRedirectionInd>true</PaymentRedirectionInd>
<PaymentTypeCode>CF</PaymentTypeCode>
</PaymentSupportedMethod> |
Info |
---|
Note |
Payment Method Processing
Some payments happen "offline" to the NDC messages, some "online" within them. If an airline needs to explicitly tell a Seller that a payment instrument will be processed via redirection, which is an "offline" capability, the "PaymentRedirectionIndicator" element should be populated as "true":
Code Block | ||
---|---|---|
| ||
<PaymentSupportedMethod>
<PaymentRedirectionInd>true</PaymentRedirectionInd>
</PaymentSupportedMethod> |
Otherwise, the payment process is implicit in the PaymentType code used.
Info |
---|
Note |
Payment Fees
Payment Fees can be communicated in PaymentCatalogue in different ways, either as
Estimated values for information purposes
Precise values
Information that could be used by a seller to calculate a close estimate of the final fee
Estimated values
Estimated ranges represent information a seller can use to indicate a maximum and minimum payment fee. They can be expressed as percentages or values
Mimimum and Maximum Percentage
Code Block | ||
---|---|---|
| ||
<PaymentFunctions>
<PaymentSurcharge>
<PercentRangeMaximumPercent>5.00</PercentRangeMaximumPercent>
<PercentRangeMinimumPercent>0.00</PercentRangeMinimumPercent>
</PaymentSurcharge>
</PaymentFunctions> |
Mimimum and Maximum Values
If only maximum and/or minimum amounts are provided, this information can be used to provide further estimation functionality by a Seller. In the following example, we see:
A maximum amount that would be charged for a given payment method
A minimum amount that would be charged for a given payment method
Code Block | ||
---|---|---|
| ||
<PaymentFunctions>
<PaymentSurcharge>
<AmountRangeMaximumAmount CurCode="GBP">50.00</AmountRangeMaximumAmount>
<AmountRangeMinimumAmount CurCode="GBP">5.00</AmountRangeMinimumAmount>
</PaymentSurcharge>
</PaymentFunctions> |
Precision Values
Precision values can be used to specify a specific percentage or a specific amounts
Precise Percentage
Code Block | ||
---|---|---|
| ||
<PaymentFunctions>
<PaymentSurcharge>
<PrecisePercent>2.00</PrecisePercent>
</PaymentSurcharge>
</PaymentFunctions> |
Precise Amount
Code Block | ||
---|---|---|
| ||
<PaymentFunctions>
<PaymentSurcharge>
<PreciseAmount CurCode="GBP">1.99</PreciseAmount>
</PaymentSurcharge>
</PaymentFunctions> |
Information for calculations
If maximum and minimum amounts and precise percentages are used in combination, this information can be used to provide further estimation functionality by a seller. In the following example, we see:
A maximum amount that would be charged for a given payment method - i.e., a payment fee cap
A minimum amount that would be charged for a given payment method - i.e., a payment fee floor
A percentage that would be charged for a given payment method - i.e., a variable to help estimate the fee in between the floor and the cap
Code Block | ||
---|---|---|
| ||
<PaymentFunctions>
<PaymentSurcharge>
<AmountRangeMaximumAmount CurCode="GBP">50.00</AmountRangeMaximumAmount>
<AmountRangeMinimumAmount CurCode="GBP">5.00</AmountRangeMinimumAmount>
<PrecisePercent>2.00</PrecisePercent>
</PaymentSurcharge>
</PaymentFunctions> |