Authorization Code in Credit Card Payments

Authorization Code in Credit Card Payments

Authorization Code in Credit Card Payments

For all payments made by Credit Card (CC), the authorization code obtained by Iberia in the process will be returned in the OrderViewRS at the time of payment.

This authorization code will be included in the OrderViewRS for the following messages:

OrderCreate: Payment with instant Purchase.
OrderChange: Deferred Payment.
OrderChange: Flight Change.
OrderChange: Ancillaries Postsale.

NOTE: Rest of OrderView as the payment process is not involved, no payment information is being returned.

The credit card payment method (PaymentCard element) can have a total of three optional references: one for the installment information; another for the 3DS information; and one for the authorization code. The installment and 3DS functionality is not affected.

PaymentCard information is referenced to the authorization code information, which is in the PaymentFormMetadata.

The PaymentFormMetadata element will have a MetadataKey attribute with a unique key that can be referenced from the credit card payment form.

In NDC messages the authorization code will be returned in the:

/OrderViewRS/Response/Metadata/Other/OtherMetadata/PaymentFormMetadatas/PaymentFormMetadata/Text

In the Text field, you can receive:

Installment information is in the following format: “installments/#[number of installments]/#[interest rate charged]. Example of OrderViewRS: “installments/3/12” where, 3 is the number of installments, and 12 is the interest rate.
Authorization code in the following format: ‘'Authorization/[Code of Authorization]''. OrderViewRS example: ‘'Authorization/AQW45F''

<Payments>
   <Payment>
      <Type>CC</Type>
      <Method>
         <PaymentCard refs="this_is_the_key_of_the_authorization_code">
            ...
         </PaymentCard>
      ...
   </Payment>
</Payments>

<Metadata>
		<Other>
           <OtherMetadata>
                     <CurrencyMetadatas>
                        <CurrencyMetadata MetadataKey="EUR">
                           <Decimals>2</Decimals>
                        </CurrencyMetadata>
                     </CurrencyMetadatas>
           </OtherMetadata>
           <OtherMetadata>
              <PaymentFormMetadatas>
					<PaymentFormMetadata MetadataKey="KEY_QUOTAS"> --> (PaymentCard information)
						<Text>installments/3</Text> --> (Payment in three installments)
					</PaymentFormMetadata>
					<PaymentFormMetadata MetadataKey="KEY_AUTHORIZATION_CODE_1"> --> (PaymentCard information)
						<Text>Authorization/2XS56F</Text> --> (Authorization code)
					</PaymentFormMetadata>
				</PaymentFormMetadatas>
			</OtherMetadata>
		</Other>
</Metadata>

Therefore, and given that they are already being referenced for the 3DS and installments information, it would be as follows:

<PaymentCard refs="KEY_QUOTAS KEY_AUTHORIZATION_CODE_1"> Pay in installments without 3DS.
<PaymentCard refs="KEY_3DS KEY_AUTHORIZATION_CODE_1"> Pay by 3DS without installments.
<PaymentCard refs="KEY_AUTHORIZATION_CODE_1"> Pay without installments and without 3DS.

OrderViewRS - Payment Messages

OrderViewRS - Payment Messages

Credit Card Payment with installments in On Hold Order Example:

You can see in the RQ:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header/>
   <soap:Body>
      <OrderChangeRQ xmlns:tag0="http://www.iata.org/IATA/EDIST/2017.2" Version="5.000"
                          PrimaryLangID="es">
         <PointOfSale>
            <Location>
               <CountryCode>BR</CountryCode>
            </Location>
         </PointOfSale>
         <Document>
            <ReferenceVersion>5.000</ReferenceVersion>
         </Document>
         <Party>
            <Sender>
               <TravelAgencySender>
                  <Name>AgencyName</Name>
                  <Contacts>
                     <Contact>
                        <EmailContact>
                           <Address>agency@agencyemail.com</Address>
                        </EmailContact>
                        <PhoneContact>
                           <Application>MOBILE</Application>
                           <Number>+34666666666</Number>
                        </PhoneContact>
                        <Name>
                           <Surname>Perez</Surname>
                           <Given>Pepe</Given>
                        </Name>
                     </Contact>
                  </Contacts>
                  <IATA_Number>12345678</IATA_Number>
                  <AgencyID>First Agency</AgencyID>
               </TravelAgencySender>
            </Sender>
            <Participants>
               <Participant>
                  <AggregatorParticipant SequenceNumber="1">
                     <AggregatorID>00001111</AggregatorID>
                  </AggregatorParticipant>
               </Participant>
            </Participants>
         </Party>
         <Query>
            <OrderID>IB3e71d17f7885443db40dd057c1557a4bOC</OrderID>
            <Payments>
               <Payment>
                  <Type>CC</Type>
                  <Method>
                     <PaymentCard refs="KEY_QUOTAS">
                        <CardType>VI</CardType>
                        <SeriesCode>123</SeriesCode>
                        <CardHolderName>Dinel Garcia Garcia</CardHolderName>
                        <CardHolderBillingAddress>
                           <Street>ibiza 21</Street>
                           <CityName>MA</CityName>
                           <StateProv>28</StateProv>
                           <PostalCode>28900</PostalCode>
                           <CountryCode>BR</CountryCode>
                        </CardHolderBillingAddress>
                        <MaskedCardNumber>400000xxxxxx1000</MaskedCardNumber>
                        <EffectiveExpireDate>
                           <Expiration>0826</Expiration>
                        </EffectiveExpireDate>
                        <TokenizedCardNumber>8100000003151000/0001G1VX</TokenizedCardNumber>
                     </PaymentCard>
                  </Method>
                  <Amount Code="BRL">262.65</Amount>
                  <Payer>
                     <ContactInfoRefs>Payer</ContactInfoRefs>
                  </Payer>
               </Payment>
            </Payments>
            <OrderChangeMetadata>
               <Other>
                  <OtherMetadata>
                     <PaymentFormMetadatas>
                        <PaymentFormMetadata MetadataKey="KEY_QUOTAS">
                           <Text>installments/2</Text>
                        </PaymentFormMetadata>
                     </PaymentFormMetadatas>
                  </OtherMetadata>
               </Other>
            </OrderChangeMetadata>
         </Query>
         <DataLists>
            <PassengerList>
               <Passenger PassengerID="ADULT_01">
                  <PTC>ADT</PTC>
                  <Birthdate>1959-04-01</Birthdate>
                  <Individual IndividualID="IND_ADULT_01">
                     <Gender>Male</Gender>
                     <NameTitle>MR</NameTitle>
                     <GivenName>JANE</GivenName>
                     <Surname>SMITH</Surname>
                  </Individual>
                  <FOID>
                     <FOID_Number>30000529L</FOID_Number>
                     <FOID_Type>NI</FOID_Type>
                  </FOID>
                  <ContactInfoRef>ADULT_01_CONTACT</ContactInfoRef>
               </Passenger>
            </PassengerList>
            <ContactList>
               <ContactInformation ContactID="ADULT_01_CONTACT">
                  <ContactType/>
                  <ContactProvided>
                     <EmailAddress>
                        <EmailAddressValue>avalos@iberia.es</EmailAddressValue>
                     </EmailAddress>
                  </ContactProvided>
                  <ContactProvided>
                     <Phone>
                        <Label>Passenger</Label>
                        <PhoneNumber>+34666554433</PhoneNumber>
                     </Phone>
                     <Phone>
                        <Label>Emergency</Label>
                        <PhoneNumber>34666554433</PhoneNumber>
                     </Phone>
                  </ContactProvided>
                  <Individual>
                     <GivenName>CONTACTO</GivenName>
                     <Surname>EMERGENCIA</Surname>
                  </Individual>
               </ContactInformation>
               <ContactInformation ContactID="Payer">
                  <ContactType>Payer</ContactType>
                  <ContactProvided>
                     <EmailAddress>
                        <EmailAddressValue>iteggo.cavalos@iberia.es</EmailAddressValue>
                     </EmailAddress>
                  </ContactProvided>
                  <ContactProvided>
                     <Phone>
                        <Label/>
                        <PhoneNumber>1273211111</PhoneNumber>
                     </Phone>
                  </ContactProvided>
                  <IndividualRef>IND_ADULT_01</IndividualRef>
               </ContactInformation>
            </ContactList>
         </DataLists>
      </OrderChangeRQ>
   </soap:Body>
</soap:Envelope>

You can see in the RS:

Credit Card Payment with 3DS in an OrderCreateRQ example:

You can see in the RQ:

You can see in the RS:

You can see in OrderRetrieve that there is no related information:

Credit Card Payment without 3DS and without installments in Ancillaries Postsale Order Example:

You can see in the RQ any PaymentCard refs

You can see in the RS:

Authorization Code in Credit Card Payments

Authorization Code in Credit Card Payments

OrderViewRS - Payment Messages

OrderViewRS - Payment Messages