Forms of Payment Metadata
NAME | DESCRIPTION | FORMAT | ALLOWED/POSSIBLE VALUES | NDC SERVICES |
---|---|---|---|---|
<Metadata / Other / OtherMetadata / PaymentFormMetadatas> | ||||
PaymentFormMetadata Attributerefs | Reference from<PaymentCard ObjectKey> | Alphanumeric | Any | OfferPriceRS |
PaymentFormMetadata AttributeMetadataKey
| For 3DS info, this key is mandatory and can be filled in with any value: “KEY_3DS” For installments payment info, this key needs to match with installments reference in PaymentCard Refs: “KEY_QUOTAS” | Alphanumeric | Any | OfferPriceRS OrderCreate & OrderChange for payment in installments |
For all payments made by Credit Card. “KEY_AUTHORIZATION_CODE_1” | Alphanumeric | Any | OrderCreate & OrderChange - Payment | |
PaymentFormMetadata / Text
| Installments payment info. Number of installments and interest rate applied by card issuer. Examples: <Text>installments/1/0.00</Text> <Text>installments/3/1.23</Text> <Text>installments/9/variable</Text> | Alphanumeric | installments/n/X.XX where n=number of installments. where X.XX=interests rate in % Valid example: installments/3/0.00 | OfferPriceRS OrderCreate & OrderChange for payment in installments |
Authorization code payment info. Example: <Text>Authorization/2XS56F</Text> | Alphanumeric | Any | OrderCreate & OrderChange - Payment | |
PaymentFormMetadata / AugmentationPoint / AugPoint AttributeOwner | Airline code associated to 3DS Payment, in this case IB. | Alphabetical | IB | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment | Reference to IATA 3DS new schema info xsd for Secure Payment. | Alphanumeric | OrderCreate & OrderChange - Payment | |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment | Reference to IATA 3DS new schema info for Secure Payment. | Alphanumeric | OrderCreate & OrderChange - Payment Mandatory if 'AugPoint ' tag is indicated | |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment | Reference to IATA 3DS new schema info for Secure Payment. | Alphanumeric | OrderCreate & OrderChange - Payment Mandatory if 'AugPoint ' tag is indicated | |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo | This Attribute is used to reference the applicable PaymentCard in the Payments section of this message. | Alphanumeric | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentMethodCriteria / PaymentCardCriteria / SecurePayerAuthenticationVersion / CardEnrollmentVersionText | The version of 3D-Secure for which the card is enrolled. | Alphanumeric | This field must contain the specific 3DS version used for authentication:
| OrderCreate & OrderChange - Payment NDC Mandatory |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentMethodCriteria / PaymentCardCriteria / SecurePayerAuthenticationVersion / SupportedVersionText | Version of 3D-Secure supported. This tag is mandatory for schema.
| Alphanumeric | This field must contain the specific 3DS version used for authentication:
| OrderCreate & OrderChange - Payment Mandatory if 'PaymentCardSecureInfo' tag is indicated |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion1 / PayerAuthenticationResponseText | Contains the indicators and fields that convey the result of the 3D Secure authentication transaction. Applicable for 3D Secure Version 1.x.x This tag is NDC mandatory for version 1.x.x and if is not included, an error will be returned. This field is the authentication response for the 3-D Secure transaction. It is used to determine whether or not the customer has been authenticated by the card issuer. It must be included in the final authorization request. Example: eJzVWFmzosgSfudXdPQ8Gt1sbkzYRhQ7KCjI/sYOsimgoL/+lp7Tp5c5t2d67tMw8yv/WqiluJXS8WyyVFEQT28qz | Alphanumeric | Any | OrderCreate & OrderChange - Payment NDC Mandatory for 3DS version 1.x.x |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / AuthenticationMerchantName | Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to name of the merchant assigned by the Acquirer or Payment System. | Alphanumeric Maximum → 40 characters | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / AuthenticationValue | Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to 3DS authentication value returned. It is a cryptographic value generated by the ACS to provide a way, during authorisation processing, for the authorisation system to validate the integrity of the authentication result. The AV algorithm is defined by each Payment System. | Alphanumeric Maximum → 28 characters | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / DirectoryServerTrxID | Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to DS (Directory Server) transaction ID returned. Universally unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction. | Alphanumeric Maximum → 36 characters | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / ElectronicCommerceInd | Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to 3DS ECI (electronic commerce indicator). Payment System-specific value provided by the ACS or DS to indicate the results of the attempt to authenticate the Cardholder. This tag is NDC mandatory for version 2.x.x and if is not included, an error will be returned. Some ECI values and the meaning of this is the following:
| Numeric Two characters | Any | OrderCreate & OrderChange - Payment NDC Mandatory for 3DS version 2.x.x |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / ProgramProtocolText | Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to Program Protocol. | Alphanumeric | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / TrxStatusReasonText | Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field provides information on why the Transaction Status field has the specified value | Alphanumeric Two characters | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / TrxStatusText | Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field indicates whether a transaction qualifies as an authenticated transaction or account verification. | Alphabetic One character | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecureProgram / EnrollmentStatusText | Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS. 3D Secure Program Enrollment Status. Examples → CardNotEnrolled, CardEnrolled, CardMayBeEnrolled, Unknown | Alphabetic | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecureProgram / SecurePaymentProgramName | Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS. Name of the secure payment program. Example → Verified by Visa. | Alphanumeric | Any | OrderCreate & OrderChange - Payment |
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SellerOwnCardInd | Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS. When TRUE, indicates the seller is using their own card. If FALSE, customer card is being used. | Boolean | true/false | OrderCreate & OrderChange - Payment |
Forms of Payment Metadata example