/
Payment in Installments

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.

 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

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

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

 

Possible returned errors

Possible returned errors

The following are the errors that could be returned:

NDC_DIST_2191

Number of installments not supported for this market and card

NDC_DIST_2192

Payment by installments not available for {0} market

NDC_DIST_2193

Incorrect installment request format

NDC_DIST_2194

Installment payments not accepted for changes

 

 

 

Related content

Markets Currencies / Forms of Payments
Markets Currencies / Forms of Payments
Read with this
Hot News
Read with this
Parameters - OverrideCurrency
Parameters - OverrideCurrency
Read with this
Spanish Discounts, Private Fares, and Hola Madrid
Spanish Discounts, Private Fares, and Hola Madrid
Read with this