{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"A seller is able to communicate a number of preferences within their request for offers, for pricing or when requesting to create or change an order. Payment Preference is expressed using the PaymentMethodCriteria structure under PaymentFunctions. The following are a series of examples outlining its use.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Payment Preference at time of Shopping","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Seller","type":"text"}]},{"type":"paragraph","content":[{"text":"A Seller can express a payment preference at time of shopping by populating PaymentMethodCriteria under Payment Functions. In the following example, the preference is for payment type \"CA\" which is defined as \"Settle on account\" from the codeset PAYT.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"markup"},"content":[{"text":"\n\t\n\t\tCA\n\t\t\n\t\t\tPreferred\n\t\t\n\t\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Airline","type":"text"}]},{"type":"paragraph","content":[{"text":"An Airline returns accepted payment methods - the Payment Catalogue - using the PaymentSupportedMethod function. If a preference was expressed by a seller and the payment method is accepted by the airline, the airline will: ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Associate the preferred payment method to offers","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally return the other accepted methods unassociated","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"markup"},"content":[{"text":"\n\t\n\t\tOfferID\n\t\tXB\n\t\n\t\n\t\tCA\n\t\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Payment Preference at time of Pricing","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Seller","type":"text"}]},{"type":"paragraph","content":[{"text":"A Seller can express a payment preference at time of pricing by populating PaymentMethodCriteria under Payment Functions. In the following example, the preference is for payment type \"CC\" which is defined as \"Customer Card\" from the codeset PAYT. Additional information can be used to provide extra precision which is necessary for determining, for example, an actual fee to be charged for payment processing. In this example, the type of card product, the type of card and the card ownership are all used.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"markup"},"content":[{"text":"\n\tVI\n\tCC\n\t\n\t\t\n\t\t\tconsumer\n\t\t\tdebit card\n\t\t\n\t\n\t\n\t\tPreferred\n\t\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Airline","type":"text"}]},{"type":"paragraph","content":[{"text":"An airline can return different levels of precision for a payment method depending on whether they are returning a catalogue or a detailed piece of information about a specific payment method. At time of pricing the airline can","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Associate the preferred payment method to offers","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a precise value of a payment fee, if there is one","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide additional instructions relating to payment processing (such as a requirement to enact 3DS authentication)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally return the other accepted methods unassociated","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In the following example, an airline has provided detailed requirements for processing a customer credit card as well as the exact fee to be charged for processing it.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"markup"},"content":[{"text":"\n\tVI\n\t\n\t\t\n\t\t\tconsumer\n\t\t\tdebit card\n\t\t\t\n\t\t\t\t3DS2\n\t\t\t\n\t\t\ttrue\n\t\t\n\t\n\t\n\t\t50\n\t\n\tCC\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Payment Preference at time of Ordering","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Seller","type":"text"}]},{"type":"paragraph","content":[{"text":"A Seller should express a payment intent at time of Order Creation by populating PaymentMethodCriteria under Payment Functions, setting the preference level as \"Required\" and associating it to the Offer ID or to the OfferItemID(s) depending on whether all offers are requested to be purchased or not. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"markup"},"content":[{"text":"\n\t\n\t\tOfferID\n\t\tXB\n\t\n\t\n\t\tCA\n\t\t\n\t\t\tRequired\n\t\t\n\t\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Airline","type":"text"}]},{"type":"paragraph","content":[{"text":"An airline should respond with an order containing associations to the \"Required\" payment method. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"markup"},"content":[{"text":"\n\t\n\t\tOrder1\n\t\n\t\n\t\tCA\n\t\n","type":"text"}]},{"type":"paragraph"}],"version":1}