Events with Payments Integration Examples

Below is an example set of feeds for event based ticketing. It includes examples for concerts, football games, theater shows, or special events.

The payment processor used in this example is Stripe.

Merchants

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "generation_timestamp": 1534731312
  },
  "merchant": [
    {
      "category": "stadium",
      "name": "Madison Square Garden",
      "telephone": "+1 123-456-7890",
      "merchant_id": "10000001",
      "geo": {
        "address": {
          "locality": "New York",
          "country": "US",
          "region": "NY",
          "street_address": "4 Pennsylvania Plaza",
          "postal_code": "10001"
        }
      },
      "tokenization_config": {
        "tokenization_parameter": {
          "stripe:publishableKey": "merch_live_209XDVJ329VJKD",
          "gateway": "stripe",
          "stripe:version": "2017-08-15"
        }
      }
    },
    {
      "category": "stadium",
      "name": "AT&T Stadium",
      "telephone": "+1 123-456-7891",
      "merchant_id": "10000002",
      "geo": {
        "address": {
          "locality": "Arlington",
          "country": "US",
          "region": "TX",
          "street_address": "1 AT&T Way",
          "postal_code": "76011"
        }
      },
      "tokenization_config": {
        "tokenization_parameter": {
          "stripe:publishableKey": "merch_live_209XDVJ329VJKD",
          "gateway": "stripe",
          "stripe:version": "2017-08-15"
        }
      }
    },
    {
      "category": "theater",
      "name": "Prince of Wales Theatre",
      "merchant_id": "10000003",
      "geo": {
        "address": {
          "locality": "London",
          "country": "UK",
          "region": "London",
          "street_address": "Coventry St",
          "postal_code": "W1D 6AS"
        }
      },
      "tokenization_config": {
        "tokenization_parameter": {
          "stripe:publishableKey": "merch_live_209XDVJ329VJKD",
          "gateway": "stripe",
          "stripe:version": "2017-08-15"
        }
      }
    },
    {
      "category": "hotel",
      "name": "Fairmont San Jose",
      "merchant_id": "10000004",
      "geo": {
        "address": {
          "locality": "San Jose",
          "country": "US",
          "region": "CA",
          "street_address": "170 South Market Street",
          "postal_code": "95113"
        }
      },
      "tokenization_config": {
        "tokenization_parameter": {
          "stripe:publishableKey": "merch_live_209XDVJ329VJKD",
          "gateway": "stripe",
          "stripe:version": "2017-08-15"
        }
      }
    }
  ]
}

Services

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "generation_timestamp": 1534731312
  },
  "service": [
    {
      "merchant_id": "10000001",
      "service_id": "20000001",
      "localized_service_name": {
        "localized_value": [
          {
            "locale": "en",
            "value": "Beyoncé Concert World Tour"
          }
        ]
      },
      "localized_service_description": {
        "localized_value": [
          {
            "locale": "en",
            "value": "The Beyoncé World Tour and will feature all the hits from her latest album."
          }
        ]
      },
      "ticket_type": [
        {
         "localized_short_description": {
            "localized_value": [
              {
                "locale": "en",
                "value": "General Admission"
              }
            ]
          },
          "price": {
            "price_micros": 195000000,
            "currency_code": "USD"
          },
          "ticket_type_id": "1001"
        }
      ],
      "rules": {
        "min_advance_booking": 10800,
        "admission_policy": "TIME_STRICT"
      },
      "prepayment_type": "REQUIRED",
      "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS",
      "ticketing_vertical_specific_data": {
        "event_category": "EVENT_CATEGORY_CONCERT",
        "event_url": "www.selltickets.com/event/beyonce/1234",
        "entity": [
          {
            "id": "501",
            "name": "Beyoncé Knowles",
            "url": "www.beyonce.com"
          }
        ],
        "entity_type": "ENTITY_TYPE_CONCERT_TOUR",
        "entity_role": "ENTITY_ROLE_HEADLINER"
      }
    },
    {
      "merchant_id": "10000002",
      "service_id": "20000002",
      "localized_service_name": {
        "localized_value": [
          {
            "locale": "en",
            "value": "Tampa Bay Buccaneers at Dallas Cowboys"
          }
        ]
      },
      "localized_service_description": {
        "localized_value": [
          {
            "locale": "en",
            "value": "Watch the Tampa Bay Buccaneers at Dallas Cowboys game at AT&T Stadium."
          }
        ]
      },
      "ticket_type": [
        {
           "localized_short_description": {
            "localized_value": [
              {
                "locale": "en",
                "value": "Section A"
              }
            ]
          },
          "price": {
            "price_micros": 50000000,
            "currency_code": "USD"
          },
          "ticket_type_id": "1002-A"
        },
        {
          "localized_short_description": {
            "localized_value": [
              {
                "locale": "en",
                "value": "Section B"
              }
            ]
          },
          "price": {
            "price_micros": 100000000,
            "currency_code": "USD"
          },
          "ticket_type_id": "1002-B"
        },
        {
          "localized_short_description": {
            "localized_value": [
              {
                "locale": "en",
                "value": "Section C"
              }
            ]
          },
          "price": {
            "price_micros": 200000000,
            "currency_code": "USD"
          },
          "ticket_type_id": "1002-C"
        }
      ],
      "rules": {
        "min_advance_booking": 4600,
        "admission_policy": "TIME_STRICT"
      },
      "prepayment_type": "REQUIRED",
      "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS",
      "ticketing_vertical_specific_data": {
        "event_category": "EVENT_CATEGORY_SPORTS",
        "event_url": "www.selltickets.com/event/sports/4543",
        "entity": [
          {
            "id": "9010",
            "name": "Tampa Bay Buccaneers",
            "url": "www.tampabaybuccaneers.com"
          }
        ],
        "entity_type": "ENTITY_TYPE_PLAYER",
        "entity_role": "ENTITY_ROLE_HOME_TEAM"
      }
    },
    {
      "merchant_id": "10000003",
      "service_id": "20000003",
      "localized_service_name": {
        "localized_value": [
          {
            "locale": "en",
            "value": "The Lion King"
          }
        ]
      },
      "localized_service_description": {
        "localized_value": [
          {
            "locale": "en",
            "value": "Experience the award-winning Best Musical with beautifully composed music and stunning choreography."
          }
        ]
      },
      "ticket_type": [
        {
          "localized_short_description": {
            "localized_value": [
              {
                "locale": "en",
                "value": "General Admission"
              }
            ]
          },
          "price": {
            "price_micros": 90000000,
            "currency_code": "USD"
          },
          "ticket_type_id": "1003"
        }
      ],
      "rules": {
        "min_advance_booking": 19000,
        "admission_policy": "TIME_STRICT"
      },
      "prepayment_type": "REQUIRED",
      "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS",
      "ticketing_vertical_specific_data": {
        "event_category": "EVENT_CATEGORY_THEATRE",
        "event_url": "www.selltickets.com/event/theater/1923",
        "entity": [
          {
            "id": "15632",
            "name": "The Lion King",
            "url": "www.lionkingbroadway.com"
          }
        ],
        "entity_type": "ENTITY_TYPE_PLAY"
      }
    },
    {
      "name": "Champagne New Year's Bash",
      "merchant_id": "10000004",
      "service_id": "20000004",
      "localized_service_name": {
        "localized_value": [
          {
            "locale": "en",
            "value": "Champagne New Year's Bash"
          }
        ]
      },
      "localized_service_description": {
        "localized_value": [
          {
            "locale": "en",
            "value": "Celebrate the New Year by sipping rose champagne and
            cocktails. Enjoy a night of dancing and entertainment as you countdown
            to the new year.",
          }
        ]
      },
      "ticket_type": [
        {
          "localized_short_description": {
            "localized_value": [
              {
                "locale": "en",
                "value": "General Admission"
              }
            ]
          },
          "price": {
            "price_micros": 25000000,
            "currency_code": "USD"
          },
          "ticket_type_id": "1004"
        }
      ],
      "rules": {
        "min_booking_buffer_before_end_time": 1800,
        "admission_policy": "TIME_FLEXIBLE"
      },
      "prepayment_type": "REQUIRED",
      "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS",
      "ticketing_vertical_specific_data": {
        "event_url": "www.selltickets.com/event/9110",
        "entity": [
          {
            "id": "489",
            "name": "Champagne New Year's Bash",
            "url": "www.selltickets.com/event/event/info/9110"
          }
        ]
      }
    }
  ]
}

Availability

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "nonce": 19283791,
    "generation_timestamp": 1534731312
  },
  "service_availability": [
    {
      "merchant_id": "10000001",
      "service_id": "20000001",
      "availability": [
        {
          "start_sec": 1535385600,
          "duration_sec": 21600,
          "spots_open": 14,
          "spots_total": 50,
          "first_bookable_sec": 1532102400,
          "last_bookable_sec": 1534694400,
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    },
    {
      "merchant_id": "10000002",
      "service_id": "20000002",
      "availability": [
        {
          "start_sec": 1535385600,
          "duration_sec": 7200,
          "spots_open": 300,
          "spots_total": 300,
          "first_bookable_sec": 1532102400,
          "last_bookable_sec": 1534694400,
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        },
       ]
    },
    {
      "merchant_id": "10000003",
      "service_id": "20000003",
      "availability": [ //This event has 2 occurrences
        {
          "start_sec": 1534780800,
          "duration_sec": 9000,
          "spots_open": 7,
          "spots_total": 15,
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        },
        {
          "start_sec": 1535385600,
          "duration_sec": 9000,
          "spots_open": 15,
          "spots_total": 15,
          "first_bookable_sec": 1532102400,
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    },
    {
      "merchant_id": "10000004",
      "service_id": "20000004",
      "availability": [
        {
          "start_sec": 1535385600,
          "duration_sec": 28800,
          "spots_open": 38,
          "spots_total": 250,
          "first_bookable_sec": 1532102400,
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}