Data requirements for select verticals

Depending on the goods and services you provide to customers, you may need to provide additional data in your Create Checkout payloads. If required, add this data to the optional custom object within the Create Checkout request payload. See data requirements below.

Note: These merchant category flags are intended to provide a general understanding of the requirements across various verticals, though they may not cover all scenarios. Please note while your business may align with these verticals, all merchants must be reviewed and approved through Block’s standard onboarding process. Your Delivery Manager will guide you through the specific flags needed for your integration. Block reserves the right to update merchant category requirements as needed.

Consumer electronics

This data is required to be present for each Item object; it will appear in the checkout’s items array.

Attribute	Data Type	Description
name	string	The name of the item
sku	string	The SKU of the item
quantity	integer	The quantity of the item ordered
pageUrl	string	The URL of the item on your store’s website
imageUrl	string	The URL of the item’s image on your store’s website
price	object	The price of the item, containing the amount and the currency
categories	array of array of strings	The category or categories that the item belongs to
estimatedShipmentDate	string	The estimated ship date for the item

Payload structure:

1 "items": [
2   {
3     "name": "Waterproof Bluetooth Speaker",
4     "sku": "12341234",
5     "quantity": 1,
6     "pageUrl": "https://merchant.example.com/bluetoothspeaker-354193.html",
7     "imageUrl": "https://merchant.example.com/bluetoothspeaker-7378-391453-1.jpg",
8     "price": {
9       "amount": "100.00",
10       "currency": "USD"
11     },
12     "categories": [
13       [
14         "Bluetooth",
15         "Speaker",
16         "Portables"]
17         "Rechargeable"
18       ]
19       [
20         "Sale",
21         "Portable Speakers"
22       ]
23     ],
24 	  "estimatedShipmentDate": "2025-08-01"
25   }
26  ],
27 
28 }

Digital goods (software, applications)

Attribute	Data Type	Description
productType	string	The type of product.
productCategory	string	The category of the product.
subSellerId	string	The ID of the sub-seller, if applicable.
subSellerName	string	The name of the sub-seller of this product, if applicable.
recipientEmail	string	The email address of the consumer who is receiving the product.
purchaseType	string	Whether this was a subscription or one-time purchase.
consumerTenure	string	Indicates whether the consumer is new or existing, or their membership level.

Payload structure:

1 "custom": {
2  "productType": "Software",
3  "productCategory": "Software License",
4  "subSellerId": "abc123",
5  "subSellerName":"Userabc123",
6  "recipientEmail": "johnsmith@email.com",
7  "purchaseType": "subscription",
8  "consumerTenure": "membership level 1"
9 }

Education services and courses

Attribute	Data Type	Description
educationType	string	The type of educational service or course (e.g., course, workshop, tutoring).
startDate	string (datetime)	The start date and time of the service or course.
endDate	string (datetime)	The end date and time of the service or course.
eventLocation	string	Whether the service/course is online or offline.
purchaseType	string	Indicates whether it is a subscription-based or one-time purchase.
consumerTenure	string	Indicates whether the consumer is new or existing, or their membership level.

Payload structure:

1 "custom": {
2  "educationType": "course",
3  "startDate":"2022-07-10 15:00:00.000",
4  "endDate":"2022-07-10 15:00:00.000",
5  "eventLocation":"online",
6  "purchaseType": "one-time-purchase",
7  "consumerTenure": "membership level 1"
8 }

Experience and ticket sales/events

Attribute	Data Type	Description
eventName	string	The name of the event.
ticketQuantity	integer	The number of tickets purchased.
ticketPrice	string	The price of a single ticket.
eventDate	string (datetime)	The date and time of the event, in timestamp format.
eventCity	string	The city where the event is taking place.
eventState	string	The state where the event is taking place.
eventCountry	string	The country where the event is taking place.
subSellerId	string	The ID of the sub-seller, if applicable.
subSellerName	string	The name of the sub-seller, if applicable.
eventId	string	The unique identifier for the event, if applicable.
purchaseType	string	Whether this was a subscription or one-time purchase.
consumerTenure	string	Indicates whether the consumer is new or existing, or their membership level.

Payload structure:

1 "custom": {
2  "eventName": "Glastonbury Festival",
3  "ticketQuantity": "2",
4  "ticketPrice": "400.00",
5  "eventDate":"2022-07-10 15:00:00.000",
6  "eventCity": "Los Angeles",
7  "eventState": "California",
8  "eventCountry": "US",
9  "subSellerId": "abc123",
10  "subSellerName":"Userabc123",
11  "eventId":"1234567",
12  "purchaseType": "one-time-purchase",
13  "consumerTenure": "membership level 1"
14 }

Marketplaces

Attribute	Data Type	Description
subSellerId	string	The ID of the sub-seller.
subSellerName	string	The name of the sub-seller.
consumerTenure	string	Indicates whether the consumer is new or existing, or their membership level.

Payload structure:

1 "custom": {
2  "subSellerId": "abc123",
3  "subSellerName":"Userabc123",
4  "consumerTenure": "membership level 1"
5 }

Musical instruments

Attribute	Data Type	Description
condition	string	The condition of the instrument (e.g., new, used, second-hand).
consumerTenure	string	Indicates whether the consumer is new or existing, or their membership level.

Payload structure:

1 "custom": {
2   "condition": "used",
3   "consumerTenure": "membership level 1"
4 }

Services

Attribute	Data Type	Description
serviceType	string	The type of service provided (e.g., spa, cleaning, consulting).
startDate	string (datetime)	The start date and time of the service.
endDate	string (datetime)	The end date and time of the service.
eventCity	string	The city where the service is provided.
eventState	string	The state where the service is provided.
eventCountry	string	The country where the service is provided.
consumerTenure	string	Indicates whether the consumer is new or existing, or their membership level.

Payload structure:

1 "custom": {
2  "serviceType": "spa",
3  "startDate":"2022-07-10 15:00:00.000",
4  "endDate":"2022-07-10 15:00:00.000",
5  "eventCity": "Los Angeles",
6  "eventState": "California",
7  "eventCountry": "US",
8  "consumerTenure": "membership level 1"
9 }

Travel

Attribute	Data Type	Description
consumerTenure	string	Indicates whether the consumer is new or existing, or their membership level.
travel.type	string	Type of travel (e.g., flight, hotel, car rental, transportation, etc.).

Note: All travel transactions must use the consumerTenure and travel.type attributes. For type-specific attributes, see the tables below.

Flight details

Attribute	Data Type	Description
flight.departureDate	string (datetime)	The date and time of the flight’s departure.
flight.arrivalDate	string (datetime)	The date and time of the flight’s arrival.
flight.departureCity	string	The city the flight departs from.
flight.arrivalCity	string	The city the flight arrives at.
flight.airline	string	The name of the airline.
flight.class	string	The flight class (e.g., economy, business, first).
flight.passengers	integer	The number of passengers on the flight.

Hotel details

Attribute	Data Type	Description
hotel.checkInDate	string (datetime)	The check-in date and time at the hotel.
hotel.checkOutDate	string (datetime)	The check-out date and time at the hotel.
hotel.hotelCity	string	The city where the hotel is located.
hotel.hotelName	string	The name of the hotel.
hotel.hotelRating	integer	The star rating/class of the hotel.
hotel.numberOfRooms	integer	The number of rooms booked at the hotel.

Car rental details

Attribute	Data Type	Description
carRental.pickUpDate	string (datetime)	The date and time for picking up the rental car.
carRental.dropOffDate	string (datetime)	The date and time for dropping off the rental car.
carRental.pickUpLocation	string	The location for picking up the rental car.
carRental.dropOffLocation	string	The location for dropping off the rental car.
carRental.make	string	The make of the rental car (e.g., Ford).
carRental.model	string	The model of the rental car (e.g., Fiesta).
carRental.namedDriver	string	The name of the driver responsible for the rental car.

Bus/transportation details

Attribute	Data Type	Description
bus.departureDate	string (datetime)	The departure date and time for the bus.
bus.arrivalDate	string (datetime)	The arrival date and time for the bus.
bus.departureCity	string	The city the bus departs from.
bus.arrivalCity	string	The city the bus arrives at.
bus.busName	string	The name of the bus service.
bus.passengers	integer	The number of passengers on the bus.

Payload structure:

1 "custom": {
2   "consumer tenure": "membership level 1", 
3   "travel": {
4       "type":"flight",
5       "flight":{
6         "departureDate":"2022-07-10 15:00:00.000",
7         "arrivalDate":"2022-07-17 20:00:00.000",
8         "departureCity": "New York",
9         "arrivalCity": "London",
10         "airline": "British Airways",
11         "class": "economy",
12         "passengers": "2"
13       },
14       "hotel":{
15        "checkInDate": "2022-07-10 15:00:00.000",
16        "checkOutDate": "2022-07-10 15:00:00.000",
17        "hotelCity": "London", 
18        "hotelName": "The Grand",
19        "hotelRating": "3",
20        "numberOfRooms": "2",
21       },
22      "carRental":{
23        "pickUpDate":"2022-07-10 15:00:00.000",
24        "dropOffDate":"2022-07-17 20:00:00.000",
25        "pickUpLocation": "M4 6JD",
26        "dropOffLocation": "M4 6JD",
27        "make":"Ford",
28        "model":"Fiesta",
29        "namedDriver": "John Smith"
30       },
31       "bus":{
32         "departureDate":"2022-07-10 15:00:00.000",
33         "arrivalDate":"2022-07-11 20:00:00.000",
34         "departureCity": "Los Angeles",
35         "arrivalCity": "San Francisco",
36         "busName": "California Charter",
37         "passengers": "12"
38       }
39     }
40 }