Payment in Installments

 

Payment in Installments - LATAM Markets

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.

The following are the Countries and Credit Cards, issued in those countries, where installment payment can be used as of December 2023:

Country

Card Type

Country

Card Type

Brazil

VI/AC/AX/UA/EL

Argentina

VI,CA,AX,DC

Mexico

(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

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 the PaymentFormMetadata.

  • 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 MetadataKeyneeds 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

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 is KEY_QUOTAS.

  • PaymentFormMetadata with attribute MetadataKey which can be referenced from the Credit Card payment type, and contains the KEY_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

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">.