Payment in Installments
Â
Payment in Installments - LATAM Markets |
---|
In some LATAM markets, we offer passengers the ability, when paying by credit card, to pay for the Order in installments. The interest rates and number of installments allowed vary depending upon the country, the credit card used and the issuing bank.
Payment in Installments impacts the following messages:
OfferPriceRS - where we return the acceptable payment methods and installment information when applicable.
OrderCreateRQ - where the payment information is sent to us with the installment information when applicable for instant purchase bookings.
OrderChangeRQ - Payment - where the payment information is sent to us with the installment information when applicable to pay for bookings on hold (not permitted to pay for changes and additions to Orders). For further information about Unpaid or on hold Orders in NDC, please visit our OrderChange 17.2 page.
OrderViewRS - where we will return the installment payment applied.
 New or modified element | To be removed/deprecated | Unique to v2 - Branded Fares | Unique to V1 - Fare Families |
The following are the Countries and Credit Cards, issued in those countries, where installment payment can be used as of October 2024:
Country | Card Type |
---|---|
Brazil | VI/AC/AX/UA/EL |
Argentina (Currently not available) | VI,CA,AX,DC |
Mexico (Currently not available) | (VI/AC) Specific Bines and AX |
Colombia | VI/AC/AX/DC |
Chile* | VI/CA/AX/DC/CB/TP |
Peru | VI/AC/AX/DC |
*Number of quotas and interest rates are dynamic and may not be returned in the OfferPriceRS, and only be returned in the OrderViewRS for the OrderCreate and OrderChange-Payment.
Within an OfferPriceRS, in addition to the usual information, we also include the Payments and PaymentFormMetadata containing the information necessary for Installment payments, when they are applicable.
OfferPriceRS Message |
---|
In addition to the usual form of payment information, when payment in Installments is available, the following will also appear in the OfferPriceRS message:
PaymentCard refs
links the payment type to the applicable Installment information in thePaymentFormMetadata
.PaymentFormMetadata
indicates the number of Installments and the interest rate applied.Amount
is mandatory for the schema and will always have a value of '0' (zero).
<Payments>
<Payment>
<Type>CC</Type>
<Method>
<PaymentCard refs="PayMeta1 PayMeta2 PayMeta3 PayMeta4 PayMeta5 PayMeta6 PayMeta7 PayMeta8 PayMeta9" ObjectKey="PaymentCard1">
<CardType>VI</CardType>
</PaymentCard>
</Method>
<Amount>0</Amount>
</Payment>
<Payment>
<Type>CC</Type>
<Method>
<PaymentCard refs="PayMeta10 PayMeta11 PayMeta12" ObjectKey="PaymentCard2">
<CardType>AX</CardType>
</PaymentCard>
</Method>
<Amount>0</Amount>
</Payment>
<Payment>
<Type>CC</Type>
<Method>
<PaymentCard>
<CardType>EL</CardType>
</PaymentCard>
</Method>
<Amount>0</Amount>
</Payment>
<Payment>
<Type>CC</Type>
<Method>
<PaymentCard refs="PayMeta13 PayMeta14" ObjectKey="PaymentCard3">
<CardType>TP</CardType>
</PaymentCard>
</Method>
<Amount>0</Amount>
</Payment>
<Payment>
<Type>CA</Type>
<Method>
<Cash CashInd="true"/>
</Method>
<Amount>0</Amount>
</Payment>
<Payment>
<Type>MS</Type>
<Method>
<Voucher/>
</Method>
<Amount>0</Amount>
</Payment>
</Payments>
In case this payment method is allowed for a specific card type, all Information will be stored in OtherMetadata
.
For installments payment info, the MetadataKey
needs to match the installments' reference in PaymentCard refs
, as well as inPaymentFormMetadata refs
.
For this market, PaymentCard1
, which we know is the Visa, allows up to ten Installments.
In the example below, we can see <Text>installments/10/30.00</Text>
, where ‘10’ is the number of installments and ‘30.00’ is the interest rate in % applied by card issuer:
<OtherMetadata>
<PaymentFormMetadatas>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta1">
<Text>installments/2/1.50</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta2">
<Text>installments/3/2.00</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta3">
<Text>installments/4/3.00</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta4">
<Text>installments/5/3.50</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta5">
<Text>installments/6/4.50</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta6">
<Text>installments/7/6.00</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta7">
<Text>installments/8/6.50</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta8">
<Text>installments/9/4.50</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard1" MetadataKey="PayMeta9">
<Text>installments/10/0.00</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard2" MetadataKey="PayMeta10">
<Text>installments/2/2.00</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard2" MetadataKey="PayMeta11">
<Text>installments/4/4.00</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard2" MetadataKey="PayMeta12">
<Text>installments/6/6.50</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard3" MetadataKey="PayMeta13">
<Text>installments/5/15.00</Text>
</PaymentFormMetadata>
<PaymentFormMetadata refs="PaymentCard3" MetadataKey="PayMeta14">
<Text>installments/10/30.00</Text>
</PaymentFormMetadata>
</PaymentFormMetadatas>
</OtherMetadata>
Â
OrderCreateRQ & OrderChangeRQ - Payment Messages |
---|
Both the OrderCreateRQ and the OrderChangeRQ (Payment) contain the following elements:
PaymentCard refs
, where the element for the applicable Installment information isKEY_QUOTAS
.PaymentFormMetadata
with attributeMetadataKey
which can be referenced from the Credit Card payment type, and contains theKEY_QUOTAS
element.Text
, where only the number of Installments is indicated.
<Payments>
<Payment>
<Type>CC</Type>
<Method>
<PaymentCard refs="KEY_QUOTAS">
<CardType>VI</CardType>
<SeriesCode>737</SeriesCode>
<CardHolderName>JANE SMITH</CardHolderName>
<CardHolderBillingAddress>
<Street>125 PRESTON RD BRIGH</Street>
<CityName>MA</CityName>
<StateProv>BN</StateProv>
<PostalCode>BN12LP</PostalCode>
<CountryCode>BR</CountryCode>
</CardHolderBillingAddress>
<CardNumber>5555123499994444</CardNumber>
<EffectiveExpireDate>
<Expiration>0330</Expiration>
</EffectiveExpireDate>
</PaymentCard>
</Method>
<Amount Code="BRL">1541.2</Amount>
<Payer>
<ContactInfoRefs>Payer</ContactInfoRefs>
</Payer>
</Payment>
</Payments>
<OrderChangeMetadata>
<Other>
<OtherMetadata>
<PaymentFormMetadatas>
<PaymentFormMetadata MetadataKey="KEY_QUOTAS">
<Text>installments/4</Text>
</PaymentFormMetadata>
</PaymentFormMetadatas>
</OtherMetadata>
</Other>
</OrderChangeMetadata>
Â
OrderViewRS Message - Payment Information |
---|
In the following example, the CC used is EL
('ELO', specific to Brazil market):
PaymentFormMetadata
contains the number of installments along with the interest rate in % applied by card issuer. TheMetadataKey
element contains KEY_QUOTAS
.
This is also used to reference the associated 3DS info in PaymentCardSecureInfo ObjectKey.
Note: If both 3DS and payment in Installments are being used for the same Order, then the two references are included here together separated by a space (e.g. <PaymentCard refs="KEY_3DS KEY_QUOTAS">
.
Â
Â
UPDATE as of December 17, only people with an Iberia or IAGGBS account will be able to access them. Write to jira.support.ib@iberia.es and we will help you with the change. ACTUALIZACIÓN a partir del 17 de diciembre, sólo podrán acceder a ellas personas con cuenta de Iberia o IAGGBS. Escribe a jira.support.ib@iberia.es y te ayudaremos con el cambio.Â