UC02 - End to End Payment via Pre-Authenticated Card
- 15 Nov 2021
- 2 Minutes to read
- Contributors
- Print
- DarkLight
- PDF
UC02 - End to End Payment via Pre-Authenticated Card
- Updated on 15 Nov 2021
- 2 Minutes to read
- Contributors
- Print
- DarkLight
- PDF
Article Summary
Description
This use case describes an end-to-end flow whereby a customer shops at a travel seller’s website. During the shopping and pricing phases, the airline provides the seller with a series of payment options and the seller determines that they will pass through the customer's payment card. The seller proceeds to create and pay for an order using customer card, having authenticated the user and provided authentication data in the payment payload. The payment is accepted and the order is confirmed.
Capabilities Demonstrated
- C01 - Communicate Payment Catalogue
- C02 - Pay for an existing order
- C04 - Pay using Customer Card
- C05 - Seller Authenticates Payer
Preconditions / Assumptions
- Airline supports "online" card payment
- Seller will authenticate payer
Descriptive Flow
| Step | Message | Description |
|---|---|---|
1RQ | AirShoppingRQ | Seller submits travel plan(s) on behalf of a customer. |
1RS | AirShoppingRS | Airline responds with flight options and includes a catalogue of supported methods. |
2RQ | ServiceListRQ | Seller submits request for additional services for a given flight plan |
2RS | ServiceListRS | Airline responds with a list of available services |
3RQ | OfferPriceRQ | Seller requests price for a flight and non-flight service and expresses an intent to use a customer card as payment. |
3RS | OfferPriceRS | Airline responds with a qualified offer with a specific price and additional instructions for card payment |
4RQ | OrderCreateRQ | Seller commits to create the order with a commitment to pay using a customer card. |
4RS | OrderViewRS | Airline notifies seller that the order is created and that payment is expected using customer card |
5RQ | OrderChangeRQ | Seller updates the order with card processing details, including authentication data |
5RS | OrderViewRS | Airline notifies seller that the payment is successful and the order is now paid |
Post Condition
- Airline has successfully processed a payment on the customer's customer card
- Seller is in receipt of an order
Shop
The table below is a non-exhaustive list of some of the functions used to illustrate this use case.
| Message | Object | Details |
|---|---|---|
AirShoppingRQ
| Device | Optionally indicates the type of device being used and the owner. Useful for airline to determine how to handle subsequent steps such as authentication |
Device Location | Optionally indicates the location of the device. | |
AirShoppingRS
| Payment Type | Indicates a high-level type of payment method that the airline will accept as payment for an order |
Payment Brand | Optionally indicates a specific brand of payment method that the airline will accept as payment for an order | |
ServiceListRQ |
|
|
ServiceListRS |
|
|
Price
| Message | Object | Details |
|---|---|---|
OfferPriceRQ
| Payment type | Optionally indicates a payment method that the seller may provide at time of purchase |
Preference Level | Optionally Indicates a preference level for the payment method a given | |
OfferPriceRS
| Payment Type | Indicates a high-level type of payment method that the airline will accept as payment for an order |
Payment Brand | Optionally indicates a specific brand of payment method that the airline will accept as payment for an order |
Order
| Message | Object | Details |
|---|---|---|
OrderCreateRQ
| Payment type | Optionally indicates a payment method that the seller may provide at time of purchase |
Preference Level | Optionally Indicates a preference level for the payment method a given | |
OrderViewRS
| Payment Type | Indicates a high-level type of payment method that the airline will accept as payment for an order |
Payment Brand | Optionally indicates a specific brand of payment method that the airline will accept as payment for an order |
Pay
| Message | Object | Details |
|---|---|---|
OrderChangeRQ
| Payment Card | Contains a payment payload including all data relating to the customer card |
Secure Payment Version 2 | Contains additional information relating to customer authentication data | |
OrderViewRS
| Payment ID | Provides a unique reference for a given payment transaction |
Payment Status | Indicates the status of the payment transaction |
XML Samples
Indicates the status of the payment transaction
| Sequence | Message |
|---|---|
| 1RQ | AirshoppingRQ |
| 1RS | AirShoppingRS |
| 2RQ | ServiceListRQ |
| 2RS | ServiceListRS |
| 3RQ | OfferPriceRQ |
| 3RS | OfferPriceRS |
| 4RQ | OrderCreateRQ |
| 4RS | OrderViewRS |
| 5RQ | OrderChangeRQ |
| 5RS | OrderChangeRS |
Link to Samples
Was this article helpful?