An example merchants feed is provided below. Note that in this example, shard_number is left out of the metadata despite being required because it would be the default value of zero (shards are zero-indexed). Any variable left out of the feed will get its default value.
Example
JSON
{
"merchant": [
{
"category": "Fitness",
"geo": {
"address": {
"country": "USA",
"locality": "Mountain View",
"postal_code": "94043",
"region": "CA",
"street_address": "1600 Amphitheatre Pkwy"
},
"latitude": 37.422113,
"longitude": -122.084041
},
"merchant_id": "1000-0",
"name": "Merchant 0",
"num_bookings_30d": 10,
"payment_option": [
{
"description": "A membership available nation-wide",
"name": "Universal Membership",
"payment_option_id": "universal1",
"payment_option_type": "PAYMENT_OPTION_UNLIMITED",
"price": {
"currency_code": "USD",
"price_micros": 49000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"valid_interval": {
"begin_sec": 1487318400,
"end_sec": 1548921600
}
},
{
"activation_type": "ACTIVATION_ON_FIRST_USE",
"description": "A pack of 10 can only be used at Merchant 0",
"name": "10 Pack",
"payment_option_id": "merch-1000-0-pack10",
"payment_option_type": "PAYMENT_OPTION_MULTI_USE",
"price": {
"currency_code": "USD",
"price_micros": 19000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"user_restriction": {
"new_to_merchant": true
},
"valid_duration_sec": 2592000
},
{
"description": "This payment option can be applied at the availability slot level to assign different prices for staff members performing the same service.",
"name": "Alice Staff Pack",
"payment_option_id": "merch-1000-0-staff-Alice",
"payment_option_type": "PAYMENT_OPTION_UNLIMITED",
"price": {
"currency_code": "USD",
"price_micros": 49000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"valid_interval": {
"begin_sec": 1487318400,
"end_sec": 1548921600
}
},
{
"description": "This payment option can be applied at the availability slot level to assign different prices for staff members performing the same service.",
"name": "Bob Staff Pack",
"payment_option_id": "merch-1000-0-staff-Bob",
"payment_option_type": "PAYMENT_OPTION_UNLIMITED",
"price": {
"currency_code": "USD",
"price_micros": 59000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"valid_interval": {
"begin_sec": 1487318400,
"end_sec": 1548921600
}
},
{
"description": "This payment option can be applied at the availability slot level to assign different prices for staff members performing the same service.",
"name": "Chris Staff Pack",
"payment_option_id": "merch-1000-0-staff-Chris",
"payment_option_type": "PAYMENT_OPTION_UNLIMITED",
"price": {
"currency_code": "USD",
"price_micros": 69000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"valid_interval": {
"begin_sec": 1487318400,
"end_sec": 1548921600
}
}
],
"tax_rate": {
"micro_percent": 7500000
},
"telephone": "650-253-0000",
"tokenization_config": {
"tokenization_parameter": {
"gateway": "stripe",
"stripe:publishableKey": "pubkey_1234",
"stripe:version": "1.5"
}
},
"url": "www.google.com"
},
{
"category": "Fitness",
"geo": {
"address": {
"country": "USA",
"locality": "Mountain View",
"postal_code": "94043",
"region": "CA",
"street_address": "1600 Amphitheatre Pkwy"
},
"latitude": 37.422113,
"longitude": -122.084041
},
"merchant_id": "1000-1",
"name": "Merchant 1",
"num_bookings_30d": 10,
"payment_option": [
{
"description": "A membership available nation-wide",
"name": "Universal Membership",
"payment_option_id": "universal1",
"payment_option_type": "PAYMENT_OPTION_UNLIMITED",
"price": {
"currency_code": "USD",
"price_micros": 49000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"valid_interval": {
"begin_sec": 1487318400,
"end_sec": 1548921600
}
},
{
"activation_type": "ACTIVATION_ON_FIRST_USE",
"description": "A pack of 20 can only be used at Merchant 1",
"name": "20 Pack",
"payment_option_id": "merch-1000-1-pack20",
"payment_option_type": "PAYMENT_OPTION_MULTI_USE",
"price": {
"currency_code": "USD",
"price_micros": 39000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"user_restriction": {
"new_to_payment_option": true
},
"valid_duration_sec": 2592000
}
],
"payment_restrictions": {
"credit_card_restrictions": {
"credit_card_type": [
"VISA",
"MASTERCARD"
]
}
},
"tax_rate": {
"micro_percent": 7500000
},
"telephone": "650-253-0000",
"tokenization_config": {
"tokenization_parameter": {
"braintree:apiVersion": "1.5",
"braintree:clientKey": "pubkey_5678",
"braintree:merchantId": "abcdef",
"braintree:sdkVersion": "none",
"gateway": "braintree"
}
},
"url": "www.google.com"
},
{
"category": "Fitness",
"geo": {
"address": {
"country": "USA",
"locality": "Mountain View",
"postal_code": "94043",
"region": "CA",
"street_address": "1600 Amphitheatre Pkwy"
},
"latitude": 37.422113,
"longitude": -122.084041
},
"merchant_id": "1000-2",
"name": "Merchant 2",
"num_bookings_30d": 10,
"payment_option": [
{
"description": "A membership available nation-wide",
"name": "Universal Membership",
"payment_option_id": "universal1",
"payment_option_type": "PAYMENT_OPTION_UNLIMITED",
"price": {
"currency_code": "USD",
"price_micros": 49000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"valid_interval": {
"begin_sec": 1487318400,
"end_sec": 1548921600
}
},
{
"activation_type": "ACTIVATION_ON_FIRST_USE",
"description": "A pack of 10 can only be used at Merchant 2",
"name": "10 Pack",
"payment_option_id": "merch-1000-2-pack10",
"payment_option_type": "PAYMENT_OPTION_MULTI_USE",
"price": {
"currency_code": "USD",
"price_micros": 19000000
},
"purchase_interval": {
"begin_sec": 1487318400,
"end_sec": 1518854400
},
"tax_rate": {
"micro_percent": 8500000
},
"user_restriction": {
"new_to_merchant": true
},
"valid_duration_sec": 2592000
}
],
"payment_restrictions": {
"credit_card_restrictions": {
"credit_card_type": [
"AMERICAN_EXPRESS"
]
}
},
"tax_rate": {
"micro_percent": 7500000
},
"telephone": "650-253-0000",
"url": "www.google.com"
}
],
"metadata": {
"generation_timestamp": 1470175790,
"nonce": 1405785854235138178,
"processing_instruction": "PROCESS_AS_COMPLETE",
"total_shards": 1
}
}
Download single-shard example in JSON formatDownload multi-shard example in JSON format
PB3
Download single-shard example in PB3 formatDownload multi-shard example in PB3 format