Transaction Advice Addendum (TAA) - Travel & cruise

Last updated: November 29, 2023

Note

The Transaction Advice Addendum solution is only available for the American Express card scheme in the United States.

Ensure that you are classified under one of the following Merchant Category Codes (MCC):

4722
4411
7011

The Transaction Advice Addendum solution enables you to meet American Express scheme requirements.

As a travel and cruise merchant, you can send additional travel information in the API request using the airline_data and accommodation_data objects.

For the full API specification, see our API reference.

post

https://api.checkout.com/payments


1[
2   {
3      "amount": 1000,
4      "currency": "GBP",
5      "payment_type": "Regular",
6      "payment_ip": "203.0.113.0",
7      "billing_descriptor": {
8         "name": "John Smith",
9         "city": "Anytown",
10         "reference": "ref_123"
11      },
12      "reference": "ORD-123A",
13      "description": "Canada travel",
14      "processing_channel_id": "pc_q4dbxom5jbgudnjzjpz7j2z6uq",
15      "amount_allocations": [
16         {
17            "id": "ent_w4jelhppmfiufdnatam37wrfc4",
18            "amount": 1000,
19            "reference": "ORD-5023-4E89",
20            "commission": {
21               "amount": 1000,
22               "percentage": 1.125
23            }
24         }
25      ],
26      "expires_in": 604800,
27      "customer": {
28         "email": "[email protected]",
29         "name": "John Smith"
30      },
31      "shipping": {
32         "address": {
33            "address_line1": "123 Anywhere St.",
34            "address_line2": "Apt. 456",
35            "city": "Anytown",
36            "state": "AL",
37            "zip": "12345",
38            "country": "US"
39         },
40         "phone": {
41            "country_code": "+1",
42            "number": "555 123 4567"
43         }
44      },
45      "recipient": {
46         "dob": "1985-05-15",
47         "account_number": "5555554444",
48         "address": {
49            "address_line1": "654 Main St.",
50            "address_line2": "Apt. 987",
51            "city": "Anytown",
52            "state": "WY",
53            "zip": "33221",
54            "country": "US"
55         },
56         "zip": "332",
57         "first_name": "Jane",
58         "last_name": "Jones"
59      }
60   },
61   {
62      "processing": [
63         {
64            "airline_data": [
65               {
66                  "ticket": [
67                     {
68                        "number": "045-21351455613",
69                        "issue_date": "2023-05-20",
70                        "issuing_carrier_code": "AI",
71                        "travel_package_indicator": "B",
72                        "travel_agency_name": "World Tours",
73                        "travel_agency_code": "01"
74                     }
75                  ],
76                  "passenger": [
77                     {
78                        "first_name": "John",
79                        "last_name": "Smith",
80                        "date_of_birth": "1990-05-26",
81                        "address": {
82                           "country": "US"
83                        }
84                     }
85                  ],
86                  "flight_leg_details": [
87                     {
88                        "flight_number": "101",
89                        "carrier_code": "BA",
90                        "class_of_travelling": "J",
91                        "departure_airport": "LAX",
92                        "departure_date": "2023-06-19",
93                        "departure_time": "15:30",
94                        "arrival_airport": "ONT",
95                        "stop_over_code": "X",
96                        "fare_basis_code": "SPRSVR"
97                     },
98                     {
99                        "flight_number": "103",
100                        "carrier_code": "BA",
101                        "class_of_travelling": "J",
102                        "departure_airport": "ONT",
103                        "departure_date": "2023-06-23",
104                        "departure_time": "15:30",
105                        "arrival_airport": "LAX",
106                        "stop_over_code": "X",
107                        "fare_basis_code": "SPRSVR"
108                     }
109                  ]
110               }
111            ]
112         },
113         {
114            "accommodation_data": [
115               {
116                  "name": "The Lake View Hotel",
117                  "check_in_date": "2023-06-20",
118                  "check_out_date": "2023-06-23",
119                  "state": "ON",
120                  "country": "CA",
121                  "city": "Ontario",
122                  "room": [
123                     {
124                        "rate": 70,
125                        "number_of_nights_at_room_rate": 1
126                     },
127                     {
128                        "rate": 100,
129                        "number_of_nights_at_room_rate": 2
130                     }
131                  ]
132               }
133            ]
134         }
135      ]
136   }
137]

Transaction Advice Addendum (TAA) - Travel & cruise

Before you begin

Note

Endpoints

Request example